03_classification.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Chapter 3 – Classification**\n",
    "\n",
    "_This notebook contains all the sample code and solutions to the exercises in chapter 3._"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Setup"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "First, let's import a few common modules, ensure MatplotLib plots figures inline and prepare a function to save the figures. We also check that Python 3.5 or later is installed (although Python 2.x may work, it is deprecated so we strongly recommend you use Python 3 instead), as well as Scikit-Learn ≥0.20."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Python ≥3.5 is required\n",
    "import sys\n",
    "assert sys.version_info >= (3, 5)\n",
    "\n",
    "# Scikit-Learn ≥0.20 is required\n",
    "import sklearn\n",
    "assert sklearn.__version__ >= \"0.20\"\n",
    "\n",
    "# Common imports\n",
    "import numpy as np\n",
    "import os\n",
    "\n",
    "# to make this notebook's output stable across runs\n",
    "np.random.seed(42)\n",
    "\n",
    "# To plot pretty figures\n",
    "%matplotlib inline\n",
    "import matplotlib as mpl\n",
    "import matplotlib.pyplot as plt\n",
    "mpl.rc('axes', labelsize=14)\n",
    "mpl.rc('xtick', labelsize=12)\n",
    "mpl.rc('ytick', labelsize=12)\n",
    "\n",
    "# Where to save the figures\n",
    "PROJECT_ROOT_DIR = \".\"\n",
    "CHAPTER_ID = \"classification\"\n",
    "IMAGES_PATH = os.path.join(PROJECT_ROOT_DIR, \"images\", CHAPTER_ID)\n",
    "os.makedirs(IMAGES_PATH, exist_ok=True)\n",
    "\n",
    "def save_fig(fig_id, tight_layout=True, fig_extension=\"png\", resolution=300):\n",
    "    path = os.path.join(IMAGES_PATH, fig_id + \".\" + fig_extension)\n",
    "    print(\"Saving figure\", fig_id)\n",
    "    if tight_layout:\n",
    "        plt.tight_layout()\n",
    "    plt.savefig(path, format=fig_extension, dpi=resolution)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# MNIST"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "dict_keys(['data', 'target', 'feature_names', 'DESCR', 'details', 'categories', 'url'])"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.datasets import fetch_openml\n",
    "mnist = fetch_openml('mnist_784', version=1)\n",
    "mnist.keys()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(70000, 784)"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X, y = mnist[\"data\"], mnist[\"target\"]\n",
    "X.shape"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(70000,)"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y.shape"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "784"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "28 * 28"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure some_digit_plot\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": [
    "%matplotlib inline\n",
    "import matplotlib as mpl\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "some_digit = X[0]\n",
    "some_digit_image = some_digit.reshape(28, 28)\n",
    "plt.imshow(some_digit_image, cmap = mpl.cm.binary, interpolation=\"nearest\")\n",
    "plt.axis(\"off\")\n",
    "\n",
    "save_fig(\"some_digit_plot\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'5'"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y[0]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "y = y.astype(np.uint8)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "def plot_digit(data):\n",
    "    image = data.reshape(28, 28)\n",
    "    plt.imshow(image, cmap = mpl.cm.binary,\n",
    "               interpolation=\"nearest\")\n",
    "    plt.axis(\"off\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "# EXTRA\n",
    "def plot_digits(instances, images_per_row=10, **options):\n",
    "    size = 28\n",
    "    images_per_row = min(len(instances), images_per_row)\n",
    "    images = [instance.reshape(size,size) for instance in instances]\n",
    "    n_rows = (len(instances) - 1) // images_per_row + 1\n",
    "    row_images = []\n",
    "    n_empty = n_rows * images_per_row - len(instances)\n",
    "    images.append(np.zeros((size, size * n_empty)))\n",
    "    for row in range(n_rows):\n",
    "        rimages = images[row * images_per_row : (row + 1) * images_per_row]\n",
    "        row_images.append(np.concatenate(rimages, axis=1))\n",
    "    image = np.concatenate(row_images, axis=0)\n",
    "    plt.imshow(image, cmap = mpl.cm.binary, **options)\n",
    "    plt.axis(\"off\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure more_digits_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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QOa4yti4ceOA2u+3docUSVfnieyIupWP3nu1axOPpNSQjXyfzcrbv/baa2v87Oijjy7mMnNyxNDMzMzMgGYaMZSll14aCN/K1S9LOXn6F8JRuXq9qcK30pSDACFioL50pYgU5srzKWXuj8b+1OaNN94Awhi9xx57DIDPP/88uYxycW644YaMy+qIulOnTkBmv6+///4bSOfItHwUURs6dGjG+crfUT9DqFmdX2l6jOIja1GE7NtvvwXgmmuuAUJU/K233gLgl19+ATKjK+oysMsuuwA1+5WmmapNdf+Uf5m9OwA1I4aifEX9zSCzOt3KR1Gknj17JuepL11jbLDBBkAYtdZUTJ48udJLKJjGdmr3aa+99gJyvy6fe+45IORRDx48GAifd7feemvGdeNeqwMHDizNHYg4YmhmZmZmQDOPGErv3r2B0CNM397jnI9hw4YBocJR+/yV6m133333AZkd0XVEEh+NFlt81KPTqoArhuyO8PHRUVylGlPEUEdXqsSbY445ksuoX5SO4tZYYw0gRFcXXHBBABZddNHkOqre7tChQ0PvTtnUVYW81FJLAeF+ptEss8wChB59ig5CmPiRL89Kr0PlWsUTXuaff34AevToUdwFl4Ci1K+99hoAffr0AcL90XM6ngzSuXNnIOSVandD/v33XwDuuOOO5Dzll+pvbpVT145LITsyquJVH1jlGFa7e+65p9JLKJh6S2o6U/Z7Vfv27ZPTL730Usa/up9ffPEFEF7vei+8+uqrS7XsnBwxNDMzMzPAEcMMK6+8MhB6BsW9lPbYYw8ALr30UgDef/99AB555JEyrjBQNCvuY6Wji759+xbt96hPYq5+aqpwjftrNZYqUtu1awcU1qtp8cUXB0JfuhVWWAEIneELoQkCcZRKUbZqoGrEfLlj2TmHaaSqb+VJxlN4lGukqL4ea70u5513XiBML4ojhjovzfQ6VtRPuxii1586Jqy33nrJz5SXpH6U2ZXoek7HzwG9ZjRTvhpm6eaLnD399NNAdcxK1meMeudCqErefPPNAZhtttnqvB1NMoqr06udnttQXX0MNYtdNQqKwuv9TBPBWrdunVxHtQFPPfUUECKH2fmImlwVz9PWc0c1EqXgiKGZmZmZAf5iaGZmZmbTeSs5B4WAd9111+S8AQMGACE5XNsXCuuqiKGStAVRjFY62kI+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iWaN8s033wDQu3dvAJ5//nkAWrQIE5BWXnllAK666qoyr87MrG7PPvssAJtvvjkA888/PwD7778/AAsuuGBlFtbEOWJoZmZmZgC0+O+//yq9hlxKsqjLLrsMgCOOOAKAX375peDrPvbYYwBstNFGxV+YJX799Vcg5MLNOuusyc9effVVIDxu119/PQAbbrghAG3btq3z9hdaaCEAevXqBcCaa65ZjGWnhqqODz/8cADuv/9+APQ6P/3005PL6r7r71dNdH922mknAB544AEg7AYsuuiilVmYFcXo0aOT0w8//DAAb7zxBgDvvvtuxmXXWWcdAO69997kvFatWpV6ian022+/AdCtWzcAvvjiCyBE3gCWWGKJci+r3rSbt/322wOw7777AnDyyScDMMccc1RmYU1Pi1xnOmJoZmZmZkAzixj+8MMPAKywwgpAyMMqxDzzzAOESFb37t2LvDoDOPLIIwE488wzS/p7Zpjh/4+JVlxxRQB23HFHIESgAJZccsmSrqEUnnvuOQDWW2+9jPP1Or/hhhuS8+L7Wm2mTp0KwLLLLguEyIjyhQcMGFCZhVmDfP/990B43O65557kZ3rv7dy5c8Z1nnrqKSDsMsSVqW+//XbpFlshX375ZXL6u+++y/hZ69atAXjiiScA2GOPPYDwN3nxxReTy84111ylXGaDvf/++8npVVddFYANNtgACDsCet+2onHE0MzMzMzya1ZVyfPOOy8AJ5xwAhDysJSX0a5dOyD3BIiffvoJgIceeghovhHD+G/z+++/AzBmzBgALrnkkozLbrXVVgBcc801Bd/+7bffXudlVJmmqtp84gjCO++8A4TH8bXXXgPgzTffzPh3lVVWSa5TTRFD5RbuvPPOQIgQivp+Kbey2inHKDti+O2331ZsTZV29tlnA/DXX38BIWqmXNyYXhvKyaw0TeH5+OOPARgyZEjyM+WE6/1b9Jpee+21gcypPsOHDwfguOOOK82CS0DvQRdeeCFQ83Movn/ZPxs6dChQM1K6yCKLAOE5kUZ//PEHAHvvvXdynt6Hb7nlFqDpRgq1i6mdyFNOOQUI72dy0kknJaePOuqokq+raf61zczMzKze/MXQzMzMzIBmVnySrWPHjgC8/vrrQNiaVEg/l0mTJgGw1FJLlXh16fDoo48CcMcddwBh2xjCtmzcNDm23HLLAfVLBNffVy0pdBsxbSMuvPDCBd+uqNWNHuvsLZl99tknOa32RtXg2GOPBcJWxJZbbgnApZdeChTWyqcaKfVgu+22A2DXXXcF4LrrrqvYmkpJBRfxe9TTTz8NhHSBadOm1Xk7M844IwBLL700ULlijUceeQQIW8l9+/YFMt9n6qLt4hEjRiTnqSXLRx99VIxllsUFF1wAhGEK2eLWXTvssAMQ2qjFhSkQUknU9meXXXYp7mKLSKkCI0eOTM5TIUpTbTulIsHDDjsMgBdeeAHI/1ka22233YD6pWjVwsUnZmZmZpZfs44Y3nbbbUBomqnIYW2UrL388suXbmEV1L9/fwAmTJgAZLY5yDb33HMD0K9fPyA0TFYBxGyzzVaydTbUjTfeCIQ1i9aq6AuEEYlpte666yan9dxVsrmKpNq3b1/+hZXRZ599BsDiiy8OhKhKHClqSGS5Ur766isgtBL68MMPM37+888/A6FFC4TokF5/r7zySsG/TxGZXAV35aA2JIceeigAZ5xxBlC/Iqnx48cDocUJhEb22nnQe1UaqRhS913FGGo506ZNGyAUS8bn6XWviKva2OjnelzT+F78559/AiG6G4+iffDBByuxpJJSSyYIQwX0fUKP1zbbbAOE5792PlSEA6HgTg3fGzmm1xFDMzMzM8uvWbWryaa8JDUD1lGXjkBzUT7LrbfeWuLVld7kyZOT08OGDQPg6quvBkJrCEUh1A5hpZVWSq4z++yzAyFakzZxi4aDDjoIgFGjRuW8rEZGKe80ze6++24g5KVAyE1R7pEem+ZGUYi4QfLAgQMrtZyCKZdXLTs+/fTTgq+r/EC1cVJkQnlne+65JxCiqzE1+68UjRhV+6iGjDqLc+/k66+/BsIOgUaqpZHapan9lyJo2snKFfH+4IMPgJBTrDZNc845JwDHH388kM5IoShCqui37m9T1bNnz+S0IoX6zqHIebZlllkGCO8PAJ9//jkQXvdxpLxYHDE0MzMzM6CZRwzV+DW7yXFtunTpUtI1lVNcxXfllVcCIbKmo7eWLVuWf2GN9PjjjwOZjX2zK7iUl6FKwGrIGVUVeJwHmU2jsQqp5jv//POBmtEpNUquZmlu6JuLoif5IoWKiulynTp1Sn6WXbk/33zzAeHxzRUpVFRKVauVUoyIljpEaLwlwFtvvQVkNoVOK+1cKa9O0STt0lx88cVAyC+FUM163333AWGH55hjjgFg0KBBpV52o40dOxYIn6mrr756JZdTcrl2cRoycEAjDbVDUAqOGJqZmZkZ0Mwihhqh1Lt3byD0zPv7778Lvo04T6BaTJ06FYDTTz8dCJVOiihAqJJSzkOac1PyUQW17sM///yT97LKyVtsscWA0NctzbTGV199Fag59g7C0Pls55xzDpDZJ0vR0uyKVF1WuSxNtQdipSliAvD888/nvIzydxXZUz50IfT45aJIRSmjDuUy88wzZ/xbbVSNqy4DihiqR6F6PapyG2q+ZlXZfOCBB5Z0rcUwbtw4IDzna8vplyeffBIIz9c4171axO/XOq0dHlWiK3dUufDqMKAqewh5s6V8X3bE0MzMzMyAZhYxVBWPBrXXJ1Io5513HhCiLdVAA7hPO+00IEwX6N69e3KZaowQZtMg8toihaLq1a222goIPQt79OiRXEY9pTQlpdI09UI5hnH0r127dkDILxP1OXvmmWeAUNEcUx6pjkDV+025TzfddFPG77DiiHM5VZkqyrtSdWkhkcIff/wRCLlq2bmocX60nvdNgV7LirrE0ty/UJQ/qtwxUVX5tttuC2RGnPTaHzBgABDeq6rBDTfcAIS87lxTxK699log5FLqua3PqTPPPBOAAw44oKRrLSZFgiE8ftqd0XvByy+/nHEdfabpvbhcHDE0MzMzM6CZRQyVW6hcuyFDhgC5jzTz0WSCanLqqadm/F9TFZpClDDWp08fIESG46MvTQTI56WXXsr4F0LejmaX6vmywAILFGfBBdJ85+y5r5pyAmFGsCadqBpTVax33XUXEDrsA2y66aYADB48GIApU6YAId9UVdBWGvFcbj0/55lnHiDkEcW5RXXRXGxVporyseLpCfW53bTTDpByyGObb755zuuo16OmR2h2LcD2228P5J7TXkqqFC+EIr6ahqJc6WqgXrl6jitiGncSOPHEEwG4/PLLgZr9/jQVRn3+8j3OaaLKcQjvtfq8UTRYkUT1o6xUn1FHDM3MzMwM8BdDMzMzM5uuWW0li5o4a9ste8tMxQtx6X/cXLTarL322kAIWythN264qW3Fata5c2cgbDfEzYK1dfTNN98AcMcddwBw1VVXAblbv0ybNg0ICcJqE6M2EjPMUJ7jKhWOaEtb4q1IjWrU/dMW0/333w+EJHxtk0FIeH7/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QePGjQOgW7duGee/++67QObWVTXSFvJ1110HhPsr2krOteX0wQcfANCuXbsSrrC4PvnkEwDOPfdcAC6++GIA/v777+QyO+20EwA33nhjmVdXHkrN0DbNN998A8Ass8wCwEUXXQRA//79K7C6hlHqwyqrrFLjZ9qyuu222wCYYYb0HBePHz8egKeffhqAsWPHAnDfffeV9PcqJUZ/m5VXXrmkv6+UPv300+T0OuusA4S/Y7m2VLPp80Fb97koteGWW24p2u/V/dVzXa/xYtMW8m677QaEFK/G0nr1t5lvvvkAmHXWWTMud8455wCZxWZWL95KNjMzM7P8qr5aQIm6Sy21FAC9evUqye9RNKWa/fTTT0BIat5zzz2Tn3333XdAzaT2Dh06ACFi+P7775d8naWkZG1FmBXpveyyy4BQvAAhmnLccccB4W9Rzf7555/k9CWXXALUfG4vuOCCAKy77rrlW1gj6X7VFplRBDhNkUJRpPCggw6q9XKKyhdyH7766isA/vjjj7yX0XN8/vnnByofMVRbsNlmmy05b/HFFy/oumolBiGyNNdccxVxdfW36aabAvD555+X9fdOmDABgLXWWgsIhYIQCkSKQZ8bxYoUip4Hku/v17dvXwDuuOOO5DzdZ2u49L1DmpmZmVlFVH3EUHlSe+yxBwCPPPIIAGuuuWajbzs+Cjr77LNzXkZ5IWr1kUbKA7n88suB8DdSFBDyt6s44ogjAJg2bRoAe++9d8nWWWxxmxI9fsOHDwdCxPDII48EYJ555gHg1VdfTa6jaEqlow7FpGbPAEOHDs15GUUS1Ri5Ghx22GFAaDxfrbbZZhsgvGYXWmghILzu9HospG2HIkOHHHJI0ddZbHfeeScQIlvaCYK688f1nFYrHwjP7UrnPSuile/zA0LLNe1M6H1a+YmNoc/HeDCBoonFyLscNGhQo2+jMb744gsA1ltvveQ8tWXSe0F2K59qoM/mDz/8MO9lFEnPzrssBkcMzczMzAyosoihGrXmMmXKFCAcdRXjaCHOp3vxxRcbfDuVcv311wOhYixbXJEeRw/zXaa2y6XRNddck5w++uijATj//PMBOPDAA3NeR1WMEHLt2rZtW6olls3HH38M1J7DtskmmwBhpFo1uOKKKwC48sorK7ySxunXrx8QXqtffvklEHLtllhiiXrfZiG5Voo8tmnT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vKYQMbzllluAEAWMo386L5/FFlusdAurp/PPPx+An3/+OefPN9lkEwCOPfbY5LyZZqr6jzbGjx8PwAsvvACEPHDIHwVXztqKK64IhFzxUtPnr6Lvsf/9739AyAV9//33C77dmWeeGQjRYOWM5rv/afbee+8lp994442cl1E18n777VeWNeXjiKGZmZmZAVUWMbzxxhuT08888wwQIiE6uiomVcEBjBs3DmgauSu5LLvsskCofMu+n9988w2QmcOiqOy1114LhEqqSvfQUpTsn3/+Sc7LFwFtahQNvu2224BQ1aYj+nwVugBjx44FwtGsckj33HPP0iy2CP7++28gc5Rhc5OdL6jHXufXRrmEhx56KAA77LBDKZZYb0cccURy+uabb671so888kipl1MRP/74IwBTp06t93W1izPDDP8f+1G1cqnsscceQN2PVUMdddRRQIiAXiNoVxYAACAASURBVHXVVQDMN998Jfl9xaTPzngHRlXJ2dKSI+qIoZmZmZkBVRYxVFUahMiHcg3atWuXcVnlCM0///zJeSussEKttz9hwgQg5LTEuRA33HADEI6sm5o55pgDqBkp1FHrFVdcAcAXX3xR47p77bUXANtttx0QcpsqRZHehRdeODlPa2yq1AdL1W7K9dltt92AkIP3119/JdcZMmQIAN9++23GbekIV73g0kw5VYXQc/jll18G4LLLLivJmspNj3l27vD2228PhNdlLC2RwXziHPHsvDW95x944IFlXVOpKbdXOa/Z4p7D//77b623pdfwJ598UqTV1e7PP/8EYPXVVweK1/VBk0GUZ3n33XcDMGDAAAC23nrrovyeUlJubL4oIYRJPdq5qzRHDM3MzMwMqLKIYfxtWkckmlrQmCNg5eLU1icqOyLZ1Cg6pL/BSiutBIS8CE2UyEVH8Ntss00pl1gnRTdfffVVIDNK2KFDh4qsqVxGjRoFhOiK+k2qsl6vlzhi+PbbbwNw8cUXA6E/nB7Pueaaq9TLrjflwCqfNZ94mokmnMiUKVOAEHVJ6fSnWh122GHJaVUYK0KoXY111123/AtrJO3avPXWW3kvo3y2c845pxxLKpvsXbBscZRQn3frrbceEHLgNfFEl9X/NS0GMnfRikU7aqoi1r+NpTzxjTfeGAifT+o8UQ0Rw9qm0ChSqLzgBRdcsCxrqosjhmZmZmYG+IuhmZmZmU1XVVvJ7777blFvT8mgCsu/8sorGT+Pt0Y33XTTov7utPn+++8B6NatW8HXWWKJJYBQxLDzzjsXe1n1cuaZZwIh8TpNTXpL7Zdffsn4vxr8aktHjd9javWUPWJMzWQPOeSQoq+zWOpqcJu9fRzL3rKrK5E/TVTYpdY0EFrOnH322UB1P+9VIFRbo/JVV121XMspmbiIT9ujcUN+gHnmmQcIW79rrLFG8rOLLroIgNlnnx3I3VgawhZz3By8FFvJKl4sNg2wyE7zSnvxVEwpO7Gll14aCAVj+baQNRZRn7EQiirVRqwUaW6OGJqZmZkZUGURw8ZSo9BHH30UgH322Qeo2a5D4qhDGhPxy2mVVVYB4KGHHkrOU3PRYiUaN1Z2km/Pnj0rtJLyyz7i1HNXUaSWLVsCmWOZsilCrmhEGtXVnkYjs3JR4Y2i49UojhSKikw08k6FZNVYfFLXqL5qp+bxispDKLTJjoLvuuuuQO1FNmqppmb0lh7auYrHyIoakC+00EI5r/viiy8CsP/++wM1dzMhDJZ47bXXAGjdunXjFhxxxNDMzMzMgGYWMTzhhBMAOOusswq6/AEHHJCcVsRFNLpGrROUb5dmytEsZMSSjl4vv/xyAHr37g2EvJc0+eGHH4CQj7L++usD+Y/GCvXpp58CsPjiizfqdspBLWd0lKojzji3qC6bb745ULp8oWLQ605Hydn0fM1FjYOrMbqinCpF1JRXCGHc4+GHH57xM51fDTmHem/68ssvgdpbCGnHR3m1uqzuP8Ass8xSknU2lnLl3nnnnaLcniLkikDla9oeR9rVDL8a3HXXXZVeQoNlD4WYc845k5916tQp53XUcm3EiBFA7kih6PNJzcWLyRFDMzMzMwOaWcTwgw8+qNfla2t4rbFrqji68cYbgbqrJctJzUGfeOIJAPbee28gHJXE5p57biCMTjv66KOBkFuYZjr6Vm6VqmkLeSy++uorIOTxqAoMwkB4NYdWvociz2nStm1bIDxn//jjDyBEU3Rf9t133xrX3X333YFQ5ZZml156KVDzse3RoweQWbmZrbZoYtooX1CNrBUpVM6omllDiAjq+a88RF22GkycOBEI0RVVjudyzz33ZPyr5/hpp52WXEbPA+UdFzP/qiG0m6HPi7gSXutXE/6xY8cCmSM966LRcdlN23Wb6thQbbI/q1SB2759+4zz464LdUXQ+vTpU6TV1S57HOGSSy6ZnNauVjaNRbz//vszzu/cuXNyWp/Jei8sBUcMzczMzAxoZhHDk046CQgjo/JRlXLcV0rRFB0FqK+Q+hApN0bROQi95MpN/RmV4xAfSedz6qmnArDffvuVbmFlstxyy9V5mdtvvx2AwYMHAyFSoZxRCH0Zlbej66QxYijKrdK/ilDkqmxUz0rl3KalujyXLbfcEgiREEVGNCaztrFTkn1dUW5lnFNcaYoYZkcK41F4linux6mRaYoS9+/fHyhND79CHHfccUB4T44j3no+Kk+wPpFCfe5k364ihRpVV5/bLDe9R2mXA0Le+BlnnJFxWY2vze7dF/dx1etcnUQ6duwIwLbbblvMZeelrgf33ntvxvnLLLNMnddV3qAoT147kgBPPvkk4IihmZmZmZVBs4oYrrDCCrX+/JlnngFC9eJ1112X/Cy7MlXDy3WU97///Q/I7BNX1+8rNlUw6chIR1eFyM7ZqGbKtcpFkSVFA1VNrkivHlcIPcIUMezXr1/R11oqOvI877zzgPC8jKs1lXekfpRpo6gPhDzS7KklteWiiQbUT548OeO6ksYouSKDyiUspLJY97MaqbpWXQ/iXN9smnyinK0777wz72WHDRsGhEpmRV7atGnTyBXXT74q+pgiTX///TfQuAi+etxVKkdcOZUQXsd6D9JjoV0avbbjiGFd9LrX80a58RB2F5ZaaikgTBkpFz1+2f2Rd9xxx7zX0Wf3q6++CoRIoXap4u8fV111VfEWm4cjhmZmZmYG+IuhmZmZmU3XrLaS81GCt7YdlPBaW2Pj1VdfHQjbiwoFb7LJJslllBhcSq+//npyWiPN4gHtEIpgtt56a6C6m4YWIlezcSUz6/HSVvL5558PhHY9cauDeGwV1N4KJW2UoKykdG29xIUz2mpJq/Hjxyen65MWAZlbWWplMWXKlIzL6G+jVjdpVMgWsgqL9DdScV01NLYWNfxVSstLL72U97IbbLABEO6n3rfVjgsynzsAjz32GBC2nTUOtVy22morAMaNG5f3MvqZmtJnF8p8/PHHyWkVNmSPd9Rz+eWXXwbK/56l9ay44orJeflGztZGn73ZxRjaWtVnXTWJi0XUsF5/ryOPPBIIBVSDBg0CwljLeCiHhhdoi3y22WYr+lodMTQzMzMzwBFDICTha1ScSv0LsfbaawMhqf/rr78u8upqp8gX1IwU6ihVo6IUXWxqEcMFF1wQCInrag4aJySrdYGigGpyqkihmoF37949uY6iFieffDIAXbt2Lc0dKKI33ngDgAEDBgAhUqgCi6FDh1ZmYSXSs2fPnOcfccQRyWm17MhWqRYet9xyCxCiBg0Rtx9SgZEihHW140ojFf5pNF5tVBz44IMPAmHEW21j9OSaa64Byh8xrK25+lprrQWEteVrqaO2LpC/bZGKIeP3vnLS52CrVq2S8xQx1HuP7t+uu+4K5B5EoIi/xjtqEEG+xtBpMvvsswMh+q0iRrWgAnjkkUeA8LkUt7mDEAU85phjgMxm9Rp1qSEbpRhT64ihmZmZmQGOGAKhjYVaCuy0004AHHXUUclllNciamx99913A/DXX3+VfJ0xHSXraATCkafaAeioQ20P8g1Yr3bKtVDkcOTIkUDIA4XQoFx5ZWqIqqiDRsXFOS2nnHIKEHKY0kxH1FqrIqDKMdLfpKnJjvyokXCcz9OQ8Xml1LdvXyCMroMQ5csXRVSEKL6OqKWNogrVlFsoynddaaWVAHj22WfrvI5GnCo/sbbWRXPOOSeQmYdYTnquxe/XopwxDSLQ81N5hHouxxHR7PuqUWqVihSKdmAUxYaQ373ddtsBheXEqYWW3tP1/lYNFMHTdwY95rny12eYIXdsbvjw4XlvX6NZS9lizhFDMzMzMwOgRSF5GRVQ1kUdcsghAFxwwQUZ5+soE2rmfSifT5EZufrqq5PT8Xi1YlEOjsZ4xYO6deQc5zLEdKSm6KaOxgAefvhhoHINUYtB0VtVHsePzQILLJBxWTUhVU5oy5Ytgcyq3QMPPBDIbAqdVhr7pBxDNf9VZDuOnlaL+PWo16jerxQxufLKK4FQhVlbdEX5uIq2V4oqLuNKa0X5lFOlTgnZ1dj6ufIU4+s2BYoMKQcYwt8in+znRC69e/cGQlVruWn0ZvZnDISReLly7XJdLr6sPpf0fKiGHLz60Pua8uNVxZvWpvwx7T4piltI/mw+cQRRuZpFGrmb80XjiKGZmZmZAc4xBOD0008HwkgeVZDFvdDi07ko10mVVqWiHlfZ/asgVCGLRhBpPJKiZKKjaKjuSKH06tULCEdX8Ui1e+65J+OyOtJWFd8BBxwAhBynNFPkYMyYMcl56ts2xxxzACFCUY2RQokjQIqQZEdX9Pjlu1x83oknnli6xdaDepLF+YLZEULlDSovS/9XX7OmSpXi8Zi7Sy65BAh/L+UHF0K7KLqNSilkJF5dtKsB0LZtWyC8t+t+NjXKWaxG2hnQblycd6neqsqTFeUYKz9RY/TiKu+6IsvF4IihmZmZmQHOMcyg3Dt1H48rG3NF6CAcqembfm15LsWgqSy5+tGpGqpLly4ATJgwAcjMQwTo1q0bkNnPsJqPzJobDVqPu/8rknzSSScBIT+ymo0ePTo5rYiuokV1HTWrUh1Cxbmq+VSlb9VFj/1FF10EwNixYwGYddZZM34OYcqTqpArnZP23XffAaEiPZ6AUleOoaqU44rj7Eh5U6Uom6r2qynHsDYfffQREPrmTpo0CQi7XGXMFXWOoZmZmZnl54hhlVEUcNNNNwXgm2++Kfi6yj+76aabgHBUbdXhnXfeAcLRpPpvQpj0oSPrhRZaqMyrKy314NQEl7oihtn5tGZpoN0bRQ4h9DHUc1q9VpVvqR6I+SaiNGVNNWIo+gzWLuXjjz8O5O9vWAKOGJqZmZlZfv5iaGZmZmaAt5Kr1ptvvgmE5FXIv62sZtiHH344ABtttFGJV2fFpMKSrl27AqE1jYqIAEaNGgU0rWbHuai4Rq1nFllkESC0mJJKjwYzs8bTOL2JEycCoV1TOVq2NBPeSjYzMzOz/BwxNEspjVTaZJNNAPj2228B2G233YDQKBmqY2yfmZmliiOGZmZmZpafI4ZmKfPPP/8AMGDAAAD+/PNPAPbcc08gM6/UzMysgRwxNDMzM7P8HDE0MzMza34cMTQzMzOz/PzF0MzMzMwAfzE0MzMzs+n8xdDMzMzMAH8xNDMzM7Pp/MXQzMzMzAB/MTQzMzOz6fzF0MzMzMwAfzE0MzMzs+n8xdDMzMzMAJip0guw6nDWWWcBcMIJJyTnDR8+HIDDDjusEksyMzOzInPE0MzMzMwARwwz9OzZE4B7770XgIsvvjj52X777VeRNZXShAkTktP//vtvxs/mmmsuAJZaaqmM86dOnZqcHj16NOCIoZmVzrRp0wAYNGgQAK+88goAbdq0AaBDhw4AbLfddsl1ll9+eQBat25dtnVaYV599VUA9txzTwDGjx8PwLbbbptc5uqrrwagVatWZV5deTz11FNAeC6PGDECgJ9//jnn5f/777/k9Oeffw5A2/9j7zwDnajWLvzYELGLHRURBQVRLNgbKqBiBwtKERuIDbsg4kUUsYCFa8XeERWxiyAWbIgdUCxYUFCwK2C/34+PNXuSk5yWnrOeP8mZzMzZSSaTzNrrXW+jRjkbnxVDY4wxxhgDWDEE4M8//wRg/vz5ACy22GIAXH311dE6Rx55JAArrLBCnkeXPb7//nsATj31VAAeeuih6LE//vgDCM+9YcOGALz++utp99ekSZOcjNNkzhdffAFA9+7dAXjxxReB8P5CuAqVuqKrWCkx+aZbt24ANG7cGICDDjqo1vtab731ovuFej4mOyy++P/rF3379gXgvPPOA+DJJ58Ewrnr3nvvjbaRyvjqq68C0LRp0/wMtkDEvd8AgwYNqva2EydOBGC33XbL4ogq8s477wDQrl07AH744QcA6tevD8AjjzwSrXvMMccAsM8+++R0TPlA6mf8PZEy+MsvvwDhvBw/P6dj2223BWCJJZYAoEePHgB07doVgGbNmmU8ZiuGxhhjjDEGgMXic9dFRF4HpV/te+65JwBTpkypsM6cOXMAWGONNfI3sCwxadIkAC644AIAnn/++Qrr6DhIvmLRVZ4U02+++SZ6bMaMGUBp+Hj0/PQ+jh49GoAHH3wQgE8++QRIVEjjqlOp8MEHHwBBVRk7diyQ+v1NXta+fXsAnnrqqfwMNok2bdoAwXdT2Vir+jv+3q266qoA3HnnnUBQSEsRzWrE/Vjjxo0DKn52da6S+hLnuOOOA4I6Wyz8+OOPQFCxIMx0TJ8+HYBrrrkGgKWXXhoInvD1118/2mb33XcHoEGDBkD4XJQLUghrogxWRa5/C4wYMQKAU045BQjfG2+//TYAl156abSu1N93330XKPxxOnv2bCCcS+rVq1flNhMmTACgU6dOAPz6668V1kn3vZtuvcrWHTZsGBCU9WqScmdWDI0xxhhjDGCPIRA8LJqzFwMHDozul4Iqlow8OIceeigACxcuTHhcVX4QrkjkRRs/fjwQruI+/PBDIHgPoXhfE1VtxT0ro0aNAoJ6msyyyy4LBIWh1Lj77rsBOOOMM4CgLG255ZZAUIjiSpOUcfl4Cq2kvfHGGwDceOONQFCkAV566aUa7eu3336L7kuBlAdHf5cC+szqc3nIIYcA4f2FcP5aa621gJAwMHfuXAAuueSSCvv99NNPAbjvvvtyMexq89dffwFB+VIShJTDytBrc+CBBwIhJQFCNetHH30EhOdbyl7D+ExPJkqhvIS77rprhiPKjGTVes0114wekwdPymG/fv3yPLpEnnjiCQD2228/IHGs6WjevDkA55xzDpDoA9X3jJ7nSiutBATVW37rRx99FEg9yyc23HBDADp27FjlmKqLFUNjjDHGGAP4h6ExxhhjjFmEp5KBL7/8EqgYzaLlUD2zabEhaVlm1datWwPwzDPPAIkxHpKqZeg++eSTE5b//fffAOy99965HXQtUECqpszGjBkDhBgLCBK9npeez/XXXw+EwguZi0sNTSHrPb3hhhuAEPkyb948AB5++OFom3vuuQcI5uj+/fvnZ7BV0KtXr4z3EZ8u3mabbQBo2bJlxvvNF7JDnH322UCwQohVVlklun/llVcCYapcxXSauorHbolisYEcffTRANx///1ACKtWu00I0+cy76tgbOjQoUD4nCv+BOD3338HQmOCUp5CFm3btq2wLN20sJbnOoKmrqBp75qwzjrrAHDUUUcBsPrqq0ePafpXhTe77LILEAp0dD6vDH2nPf744wBstNFGNR5jOqwYGmOMMcYYwIphWZMcmrn11lsDsNxyy1VYV1eWUtI6dOiQ8Pi+++4LhLDOQqIoC6kNitCRSnD88ccDQUEB2GqrrYBg+lUMjxTDVq1a5XrYWeeiiy6K7qvQQMUlyeHQiuv47rvvomUqaOjduzdQumppKnSsQzj+VaRQzKho5oADDgDCcaqiL72/J510UrTNpptumrCPmTNnAokB9pCo9g8ZMiSbw64xiiGRUihVMB5SnYzid84991wgHLdSVxWDAmGGR4prKaDZGd0mh1bHI3zqihKoGLFSRkVh8dgoNRNQEPsee+wBVK8lnr7fWrRoAWRXKRRWDI0xxhhjDGDFEAgenXLjrLPOAuCKK64A4JZbbgFCUOx///vfaF1dkcgPIdZee20g0fNTaKR6yTOpqJnOnTsDsP/++wMhxqM6LLPMMtkcYl5QeDVUHZAqD0s8ukTbyNdVDkhFjb8eAwYMABKjeooNKYVSwaQUyjOqQPadd9457T7U2vP8888HgpImpLRBiMcoFPIy632S10r+yOq0HpUqKD9tPIpKMwFSa4oZeQeTI0mSFcNSVwmTz7GKp3rggQeA4B2N8+yzzwJBSVMMUSmhgPa4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w4qhMcYYY4wB7DE0xhhjjKmL2GNojDHGGGPS4x+GxhhjjDEG8A9DY4wxxhizCP8wNMYYY4wxgH8YGmOMMcaYRfiHoTHGGGOMAfzD0BhjjDHGLMI/DI0xxhhjDOAfhsYYY4wxZhH+YWiMMcYYYwBYstADyCe//fYbAFOnTgVg9OjRAKy44ooAvP322wDMmTMHgN69e0fbdu/eHYDFF/dvaWOMMcbklj/++AOAww47LFo2duxYABo3bgzA559/nvX/6185xhhjjDEGgMX+97//FXoMqch4UJ9++ikA559/frTsqaeeAuCnn34CoH79+gAstdRSQFAUl156aQB+//33aNvx48cDsMcee2Q6tILz3nvvAfDyyy9Hy/r06VOtbVdaaaXo/iuvvALAJptsksXRGWPqOq+99lp0XzM5V1xxBQAzZ84E4Pnnnwdg1113ze/gTN4ZPHgwAAMHDgSgVatWAPTr1w+ALl26FGZgOebNN98EoE2bNhUek2L42WefZfIvFku10IqhMcYYY4wBylgx3GuvvYBET+CGG24IQMOGDQHYfvvtAdh4440B+PnnnwFYZpllANhvv/2ibbXOmDFjMh1a3vn444+BMPbrr78eSPQmLLZYyguHSmnZsiUAt9xyCwDbbLNNJsM0xlSTWbNmRfdHjhyZ8Ngdd9wBwJdffpmw/JprronuH3/88QCMGDECgEGDBgHhM/3iiy8CUK9evWwOOy0//PADACeddBIAEyZMiB6bN29eym1WXnllANZZZ520+73ooosA2HHHHQFYZZVVMh+sqREDBgwA4JBDDgFg8803r/a28tituuqqAMyfPz/hcanFEydOzHicxcTff/8NwBFHHAHAgw8+WGGd5s2bA/DBBx9k8q+sGBpjjDHGmPT4h6ExxhhjjAHKeCpZ0yjrrbderfexxRZbRPc//PBDAL799lsAVlhhhQxGlx9++eUXANq3bw/A5MmTEx6Pv/e1mUoWl112GQBnnnlmrfdREzTu//73v9VaD8Lz++6774BgZr7qqqsSHt9///2jbWTuLSemT58e3R8yZAgA9913HwDPPfccUJxmfhUgPP7440CYFtX7KS6++GIA+vfvX+19//rrrwBccskl0TIVaJ133nlAsJ0UChXCjRo1CgjvHQSrSDbQ1PH3338PwLLLLpu1fVeGpsoOPfTQam+jz3d1zl0H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HWXWrFkA7LHHHgB8/PHHAKy22mrROhMmTACgVatWeR6dMaa6yE+YiokTJ+ZxJKY26Fx8xhlnRMtGjx6dsM5pp50GwPDhw/M3sDqMFUNjjDHGGAP4h6ExxhhjjFlE2U8lv/HGG9H9Nm3aZG2/Dz74IBDiEOJTkKZ4+eKLLwDo0KEDAJ988gkQjOvfffddtG6nTp0A+Oijj/I5xKwyb948AI477jgAHn300QrrXHjhhQAMGDAgfwPLEjfffDMAZ599NgBnnXUWAP369avxvn799dfo/qeffgrAeuutB8Aqq6yS0ThN9tEU8vPPP1/hsQsuuCDPo6k948ePB2CNNdYA4IEHHki5no5FgCZNmgDwzTffANC6dWsANt1005yNM1to6vjQQw8F4LXXXku77rrrrgvAlVdeCcB2222XsG2pot8iU6ZMAWDxxVNrdM2aNQPg7rvvjpY1btwYgFVXXTVn47NiaIwxxhhjAFjsf//7X6HHkIqMB/XMM88A0LVr12iZVL13330XgKWWWqrG+73//vsBOOqoowA44IADABg1alStx1oKDBs2DICLL744WtauXTugNJ77s88+C8BBBx0EwIIFCxIe32GHHQB45ZVXomW6Kpd6VEpcf/31QPgcPPHEE1Vuc8011wBwwgkn5G5gWULq5o033ggEpVdX4pMnT672vn7//XcADjnkkGjZ448/DsAdd9wBQPfu3TMcsckW6ZTC3XbbLbpf14pOvv/+eyB8dtOpjoXk9NNPB4L6J/S503cMBKVQz+Owww5L2KYUi1FefPHF6L5+P2gGa4kllki5zT///FPh8SOOOAKAK664AshYOUyZ8WTF0BhjjDHGAGWoGD799NNAuMKPe8aEFIJ69erVeP9jxowBwq/2+vXrA7D//vsDQWEodf79918gvI733XcfAKuvvnq0jtSozTbbLM+jqx6fffZZdH+fffYBYMaMGQnryJvz8ssvA9ClS5fosffffx8oDcVQSmfPnj2B4D2Sby7dFWkcHcvyHJ500klA7ZT1XLP++usD4Yp75ZVXBuC5554DwvtaHaQeb7/99tGy9957D6h7iuGff/4JhNdVbLTRRoUYTgJSCNPF0xTpd1nGyJP30EMPRcvkR9T56sMPPwRg7733BhLPfYVAYwbYcccdE5bJJyi1L/65S4f8lfH9QlAW+/btGy2TMlksSCk8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\n",
      "text/plain": [
       "<Figure size 648x648 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(9,9))\n",
    "example_images = X[:100]\n",
    "plot_digits(example_images, images_per_row=10)\n",
    "save_fig(\"more_digits_plot\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "5"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y[0]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [],
   "source": [
    "X_train, X_test, y_train, y_test = X[:60000], X[60000:], y[:60000], y[60000:]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Binary classifier"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_train_5 = (y_train == 5)\n",
    "y_test_5 = (y_test == 5)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note**: some hyperparameters will have a different defaut value in future versions of Scikit-Learn, such as `max_iter` and `tol`. To be future-proof, we explicitly set these hyperparameters to their future default values. For simplicity, this is not shown in the book."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "SGDClassifier(alpha=0.0001, average=False, class_weight=None,\n",
       "       early_stopping=False, epsilon=0.1, eta0=0.0, fit_intercept=True,\n",
       "       l1_ratio=0.15, learning_rate='optimal', loss='hinge', max_iter=1000,\n",
       "       n_iter=None, n_iter_no_change=5, n_jobs=None, penalty='l2',\n",
       "       power_t=0.5, random_state=42, shuffle=True, tol=0.001,\n",
       "       validation_fraction=0.1, verbose=0, warm_start=False)"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.linear_model import SGDClassifier\n",
    "\n",
    "sgd_clf = SGDClassifier(max_iter=1000, tol=1e-3, random_state=42)\n",
    "sgd_clf.fit(X_train, y_train_5)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([ True])"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sgd_clf.predict([some_digit])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([0.96355, 0.93795, 0.95615])"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.model_selection import cross_val_score\n",
    "cross_val_score(sgd_clf, X_train, y_train_5, cv=3, scoring=\"accuracy\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "0.96355\n",
      "0.93795\n",
      "0.95615\n"
     ]
    }
   ],
   "source": [
    "from sklearn.model_selection import StratifiedKFold\n",
    "from sklearn.base import clone\n",
    "\n",
    "skfolds = StratifiedKFold(n_splits=3, random_state=42)\n",
    "\n",
    "for train_index, test_index in skfolds.split(X_train, y_train_5):\n",
    "    clone_clf = clone(sgd_clf)\n",
    "    X_train_folds = X_train[train_index]\n",
    "    y_train_folds = y_train_5[train_index]\n",
    "    X_test_fold = X_train[test_index]\n",
    "    y_test_fold = y_train_5[test_index]\n",
    "\n",
    "    clone_clf.fit(X_train_folds, y_train_folds)\n",
    "    y_pred = clone_clf.predict(X_test_fold)\n",
    "    n_correct = sum(y_pred == y_test_fold)\n",
    "    print(n_correct / len(y_pred))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.base import BaseEstimator\n",
    "class Never5Classifier(BaseEstimator):\n",
    "    def fit(self, X, y=None):\n",
    "        pass\n",
    "    def predict(self, X):\n",
    "        return np.zeros((len(X), 1), dtype=bool)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([0.91125, 0.90855, 0.90915])"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "never_5_clf = Never5Classifier()\n",
    "cross_val_score(never_5_clf, X_train, y_train_5, cv=3, scoring=\"accuracy\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.model_selection import cross_val_predict\n",
    "\n",
    "y_train_pred = cross_val_predict(sgd_clf, X_train, y_train_5, cv=3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[53057,  1522],\n",
       "       [ 1325,  4096]])"
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.metrics import confusion_matrix\n",
    "\n",
    "confusion_matrix(y_train_5, y_train_pred)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[54579,     0],\n",
       "       [    0,  5421]])"
      ]
     },
     "execution_count": 23,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_train_perfect_predictions = y_train_5  # pretend we reached perfection\n",
    "confusion_matrix(y_train_5, y_train_perfect_predictions)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7290850836596654"
      ]
     },
     "execution_count": 24,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.metrics import precision_score, recall_score\n",
    "\n",
    "precision_score(y_train_5, y_train_pred)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7290850836596654"
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "4096 / (4096 + 1522)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7555801512636044"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "recall_score(y_train_5, y_train_pred)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7555801512636044"
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "4096 / (4096 + 1325)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7420962043663375"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.metrics import f1_score\n",
    "\n",
    "f1_score(y_train_5, y_train_pred)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7420962043663375"
      ]
     },
     "execution_count": 29,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "4096 / (4096 + (1522 + 1325) / 2)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([2412.53175101])"
      ]
     },
     "execution_count": 30,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_scores = sgd_clf.decision_function([some_digit])\n",
    "y_scores"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {},
   "outputs": [],
   "source": [
    "threshold = 0\n",
    "y_some_digit_pred = (y_scores > threshold)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([ True])"
      ]
     },
     "execution_count": 32,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_some_digit_pred"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([False])"
      ]
     },
     "execution_count": 33,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "threshold = 8000\n",
    "y_some_digit_pred = (y_scores > threshold)\n",
    "y_some_digit_pred"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_scores = cross_val_predict(sgd_clf, X_train, y_train_5, cv=3,\n",
    "                             method=\"decision_function\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.metrics import precision_recall_curve\n",
    "\n",
    "precisions, recalls, thresholds = precision_recall_curve(y_train_5, y_scores)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure precision_recall_vs_threshold_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjgAAAEYCAYAAABRMYxdAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4zLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvnQurowAAIABJREFUeJzs3Xl8Ddf7wPHPuTc3kciCCLHGUoLaJa31K1Vbaalqq2rpTqkuim6qtKXVVvutX9HiW0vR0oWWam0litLSFrXvexFCFknIcn5/HNkISbjJ3CTP2+u87py5Z2aem4nkyZmZc5TWGiGEEEKIwsRmdQBCCCGEEM4mCY4QQgghCh1JcIQQQghR6EiCI4QQQohCRxIcIYQQQhQ6kuAIIYQQotCRBEcIIYQQhU6OEhyl1CCl1Cal1EWl1Ixs2g5WSp1USkUrpaYppTycEqkQQgghRA7ltAfnBDAamHa9RkqpDsArwJ1AEFANePNmAhRCCCGEyK0cJTha6/la6++Bs9k0fQT4XGu9XWt9DngbePTmQhRCCCGEyB03J+/vVuCHDPUtQFmllL/WOlNypJTqB/QDwJMmlHByJC5IKYVCZf1exvUqi3VXtLUpGyr1n1KZllPbKKWwXc5hM7W7Io6s9pMaL4ANW9q+0o6b4TgFVUpKCjab3IbmyuQcuT45R67pwAFvkpKy/vlcqtQlSpe+CMCFC24cP+55zf1UrXoBhyMFgBMnPImNzTpt8PJKomLFeACSkxX793tfc5/ly8fj7Z0EQGSkO2fOZH0ni92uqV49NovP9OcZrXXANQ9wmbMTHG8gKkM9ddmHK3p/tNZTgCkAXkFeuuarNc16NKnzY2l0attMy1m1u5FtrmyXkJRAYnJilvvO6jXj9lm9d6XLLXL0hSwoHDYH3u7eFHMrRnH34njYPbDb7NiUDbu6/Hq57mZzw8/Dj2JuxfByeOHl8MrULqvisDvStvF296a4e3EcNgfudnf8ivlRyrMUfh5+OOwOHDYHbjY3PNw8sKnsf+CGh4cTFhaW918kccPkHLm+gnKO9u2DL7+EgAAYMCB9/ZEjUKIE+PiAyuHfa1OnwsSJ4OkJbdrAmDFmfWwsjBsHpUpByZKmlChhSsmSUKYMOBzO/2wAs2fDhx/Co4/C88+bzxp7OTfYvXs3wcHBaW0bNYLQULN89Cj8/PO199uzp/naACxbBocOZd2uYkXo1Mksx8fDrFnX3me7dlC1qln+6y/YtCnrdsWKQd++6fXUz9S/vzp87b2nc3aCEwv4ZqinLsdcb6M6AXXY9PQ1PmEBFR4eTuvWrYH0JOlS8iUuJV/KlAil6JRrJknXei9ZJxNzMSZtf9EXo0lMSSQpJSlTib4YnbacmJzIpeRLXEi8QFJKEskpyeZVJ5Ockkx8UjwJSQmZ1qVuG3MphoSkBGIvxRJzMSbtWInJiSSmJHIu4ZzFX+3M7MqOl8OLYm7F8PXwpaRnSUoWK4m73R2H3SRBnm6eJJ5L5A/HH3i6eWK32XGzuWFX5tXL4YWnwxOHzYHDfjmh8vDD0+GJj7sPvh6+FHMrltaTJYRwvvh42LwZbDaTmFSrZtavWwenTkFwsPlFOXEiXLoE5cpBjx5QvHjm/Xz4IQwdapbLls2c4NSrB9HRJvEoXdqUgADz+uijcNddpt2xY7Bzp1nfvz+kzlNduXL6vk6ehDevc9fp3LkmPoAlS2DVKggJMccrV87sy/PanSnXtWuX+VpFRpr6ww+nvxce/i9hYcFZblepEvTrl7NjtG+fs3aenjnfZ+PGpuRE6mfq3z9n7Z2d4GwHGgBfX643AE5deXmqqMh0GUeBp80TT8cNfve6qPjE+LTkKCohiqSUJFJ0Csk62bymJKfVLyZd5ELiBRKSEoi+GM2l5Etp71+rxCXGEZcYR3xSPOcTzqcldZeSLxEZH8nZ+LNcuHQhU9J1MfkiMZdiiLkUQ0RcBFwn/5p7dO4Nf3a7slM7oDaNyzUmwCsAD7sHPh4+FHMrhpvNLa34efgR6B2IXzE/PN08qexXGQ83ebhQFDybN0NMDJw+DTVqQP36Zv2xY/DHH/Ddd+YXZkCA6a0oUwZuvdX8dQ8QFQUXLpi/zLdtM+t27YI6dUyvQmpikpRkegOWL08/dmioOQbApEnmr/ms3H9/+nKnTrB6NcTFpa/L+Is/Kcn0rCQnm7j+/deUVHfckb68bBk88UR6vXx5+OYb8PNLX+fjAyNGmCTj3Dk4f96Uc+dMadIkve3s2TBnztXx+/qaROKbb0w9JcV8Bl9f8zX39b16GzA9MWC+/sLIUYKjlHK73NYO2JVSxYAkrXXSFU2/AGYopeZgnrx6HZjhvHCFq/F0pCdt5X3KWxyNkZicSHxSPPGJ8UTGR3I+4TxRF6NITL6cBKUkcibuDH/t+AvfQN+09ck6OVPvV2JKYlovVVxiHBcuXUhLtOIS40hISmDb6W1sO70tV/HZlZ1yPuXwcnjh4+6T1quUWkp7lSbYP5hA70D8Pf2pUqIKFX0rUta7bI4uvQlxM7ROv1Sjtfklv3r11e0+/TQ9wRk9GiZPznp/774Lr7xikom33za9KVlZuxZatDDLV17G8fIyPR2pQkNNsrRzJxw4YNbZ7SYByZgAHD6cObmZPx+6dUuvu7mlX3KJj4ezZ+HMmfSS8ZilS5vLUWfOmGMPGQLNm2eOs2xZeOutrD/flRo1MoleZCRERJg4Tp0yvUkXL6bHtHw5fPGFSR4B7r7bbPv00ybJSiUJztVy2oPzOjAyQ7038KZSahqwA6ijtT6itV6ilHofWAV4At9dsZ0Qec5hN5eVfD18Ketd9prtwi/c3L0DMRdj+OP4H+yI2EFCUgLxSfGZLgum9ihFJkTyb8y/XEi8QPTFaI5EHeFY9LFcH8/b3ZsqJaoQ7B9Mk3JNuK3CbdQrW48yxcvc8GcQRUtSkulJCLh8e+aaNbB+Pbz8cnobpWDLFnPp5uzZrJObWrUyJyE+PhAUZLZt1Qr8/U0vz6lTpgcHTDKR2pOTqnJlcw9MpUrmclPG/e/aZZb37YPq1TNv98ILpoBJYE6dgipVrr6HZuNGc9no5EkTR8belit5epr4rowxVZcupjjLkCFXr9PanJ/UBMfDw5yj8+fNOYuIgB9/NGX0aJPorFtnEiVJcK6mUm+mtVJISIjedK27jAqognLjXVFm1Tk6F3/OXEK7GENcYlzmhCglkSNRRzhw7gARFyI4En2Ef2P+5XDUYaIvRl+1L5uy0bJyS1pWakm76u1oXK4xvh7X6MMugOT/kXNobS6xdOxo7hEZMcIkA9e7heyXX+D22+Gnn0yicM89JompVCnzdrk5RxERJsnQ2iQ8dnvW7ebNg8RE6N0755+xKDh40NyQO3eu6Y1q0cIkQGDuUwLTA5R6U3Cqwvb/SCn1p9Y6JLt2zr4HRwiRjZKeJSnpWTJX22itOXXhFEeijrDpxCb+PPEn2yO2s/HERn49/Cu/Hv6Vd9a+A0CAVwB1y9SlZeWWPNLgEaqWrCqXtoqg8HDzJMu0K4ZnHTnSPGXj52eeZlm+3CQyb78NtWubXoPixc1lIYAHHjDFGQKyfbDXSL0RV2RWtaopDzxgetf27DHJZuqNxXB1clOUSYIjRAGglCLQO5BA70Buq3Bb2voTMSdYf3Q9Kw+uZP2x9fx98m8i4iJYdWgVqw6t4u1f3ybAK4CH6z1MTf+atA5qTZ2AOvL0VyGRlGR6QZSC554zj9wuWWKSE1/fq5MbMI8Ep16qWbYsf+MVzuPvD82ameWSJU0PW2pSKgxJcIQowMr7lKd7ne50r9MdgOSUZHZE7ODvk3/z7Y5v+fXwr0TERTD+9/Fp2wT5BXFvrXvpVqsbLSq3wM0mPwYKmogI84QSmN6WCxfS3/PxMTfelikDTZuax5zr1jW9NIGB174sJAoupWDBgvTLVMKQn2xCFCJ2m516ZetRr2w9+jboi9aapfuX8ueJP9n07ybWHF7D4ajDjP99PON/H4+/pz8vNH2BF5u9iJdD/vxzVaNGmXtnPv7YXF4KCIDOnWHx4szJDcCGDemDqK1fn++hCotI4no1SXCEKMSUUnS8pSMdb+kImB6elQdXsnD3Qn7e9zP7z+1nxKoRfLzhY15r9Rr9m/SnuHvxbPYq8trFi2YE2QULzM24SZcH5HjhBXOjcHCwGdxu5Ehz4+/Fi6bnpkQRmPJGiJySDi0hihC7zU676u34pNMn7H12Lz/2/JGa/jU5G3+WIcuGUPqD0tz5xZ1M+3sal5IvWR1ukaE1fPaZGdQtKcmMv7JggXkvNbmpVw8++ST9ceqgIDMeTJky5skmSW6EyEwSHCGKKKUUnWt2Ztczu5h3/zxCyoeQkJTAyoMreWLhEwR9HMQ7a97hfMJ5q0MttCIizBNDNpuZPiD13u927cxrpUrw++9mGoKtW2HQIOtiFaKgkQRHiCJOKcWDtz7Ixqc2cmzwMT7r/BnB/sGcjD3J8JXDqfFJDcauHUtcYlz2OxPZOnMGHnnEJDNlysDXX6e/9/nn5pLUiBEmqTlyBG67Le8maBSiMJMERwiRpoJvBfqH9GfnMztZ0GMBDco24EzcGV795VUaTW7E6QunrQ6xwEodU3X6dDP0fkZ9+phZkp980tRLlpSkRoibJQmOEOIqSinurXUvf/f/m7nd51LBpwJ7zu6h8n8r8/bqt+X+nFw4e9b01rRubZKcoUPT5zgaNcqs++KLq2fAFkLcHElwhBDXpJSiR90erOi7gtDyoVxMvsgb4W8QPCGY//31P0l0srF8uZmkEdLnFFLKTH2gtXkKSgiRNyTBEUJkq1bpWvz+5O981f0rqpSowqHzh3hq0VNUG1+Nb3d8a3V4LiUlxcwRVKECtG+fvn7GDHPpSQiRPyTBEULkiFKKh+o+xJ5Be/jfPf+jsl9ljscc54FvHmDQT4O4mHTR6hAtp7WZ1fq33+DEifT1Fy+aG4uFEPlHEhwhRK447A6eaPwEB547wEftP8JhczBx40RqfFKDzSc3Wx1e/pkzB6pUQdtsHHOrwjfd5qAU/PGHSXKaNzczPqekgLu71cEKUfRIgiOEuCF2m53BzQaz6pFVBPsHczT6KHfMvIM1h9dYHVremzMH3a8fHD6M0pqKyYfp+mM//v1wDoGBcPAgrFsH3bqlj20jhMhfrpHg7N5tLlADJCZCWBjMnm3qcXGmPm+eqUdFmfr8+aZ+5oypL1pk6idPmvqSJaZ+9Kipr1hh6gcOmPrq1enHDgszfcoA27aZ+saNpr55s6lvvvyX6caNpr5tm6n/9pup795t6qtXQ1gYxVL7p1esMO8fPWrqS5aY+smTpr5okamfOWPq8+ebelSUqc+bZ+pxl8cgmT3b1BMTTX3GDFNPNXUqtG2bXp80ycy2l2r8eOjSJb0+bhx0755eHzsWHnoovf7229C7d3r9jTfgscfS66++Cv36pdeHDoVnnkmvv/CCKameeca0SdWvn9lHqsceM8dI1bu3iSHVQw+ZGFN1724+Q6ouXcxnTHXXXeZrkKptW/M1ShUWVui+9zhwwNTz6XuvReUWbOq3ibEHqvPN5PPc/dXdpifHCd97tceMSa+7yPee1hDz3HBUXOZxgdyT4gj8v+EIIVyDayQ4QogCzdvdmyHNh1CiWAmiL0bT87uehfYJq6FDoXjkkSzfU0ezXi+EyH9Kp44+ZaGQkBC9adMmq8NwqvDwcMIy9qwIlyPnyPliLsYQMjWEPWf30OPWHnzV/SvUTVyjcaVzdOyYeTJq3Tqo2KoKVTh8daOgIDh0KN9js5IrnSORtcJ2jpRSf2qtQ7JrJz04Qgin8fHwYea9M7EpG/O2z+Oj9R9ZHdJNmz7d3Efz+utm0L7mzcFj3Bjw8src0MsLMl5SE0JYShIcIYRTNa3YlJn3zgTgpRUvsWj3IosjujE//gj+/vD446Y+c6aZFNNmg3JDesGUKRAYaLKfoCBT79XL2qCFEGkkwRFCOF3v+r3p17gfKTqFh+c/zNJ9S60OKcc2bjQ5yz33QGRk+vrPPoNSpTI07NULgoPhP/8xl6UkuRHCpbhZHYAQonCa2Hki5y+e5+vtX3P/N/ezfeB2KvtVtjqsbO3dm7m+fHnmBxMzmTAhz+MRQtwY6cERQuQJN5sbs7vNpnml5sReiqXPgj4kpSRZHdY1nT9vRhzu2RNeew02bTIjE18zuQGoW9cUIYTLkQRHCJFnHHYH3z34Hf6e/vx6+FdeXfFq9htZYMAAM0+Uw2EuT40ZA02a5GDD335LH8dICOFSJMERQuSpQO9A5t0/D5uyMW79ODYe32h1SJnMn2/urwHTe5Mrr71mihDC5UiCI4TIc3dWu5M+9fsAMGr1KGuDuSw+3swZlTqYct268NVXudzJ5MmmCCFcjiQ4Qoh8MbrNaGzKxk97f2LtkbWWxpKcbIatOXx5rL42bWDLFvMIeK4EB5sihHA5kuAIIfJFRd+KDGs+DIBHv3+U2EuxlsXyySfpy08+Cb/8cgPJDZj5v1LnFhNCuBRJcIQQ+ebNsDcJ9g9m/7n9PLnwScviqF7dvHbvnnnu1VwbOdIUIYTLkQRHCJFvPNw8+Kr7V9iVnXnb57Hm8Jp8OW5KCtSsaSYzj42F9u3h9Gn49tub3PG0aaYIIVyOJDhCiHzVqFwjXmrxEgBT/pqS58fbtQvsdjOA36JF8O674OEBAQFO2Hm1aqYIIVyOJDhCiHz3RKMnzISc2+ax9+ze7De4Qb17Q+3a6fWPPnLyfJgrVpgihHA5kuAIIfJd9VLV6dugL4kpiTy16Cm01k4/xrhxMGdOev3vv2HwYCcfZPRoU4QQLkcSHCGEJd5r+x7FHcVZfXg1C3YtcOq+tYZhw9LrMTHQsKFTD2HMmmWKEMLlSIIjhLBEmeJlGNt2LAAfb/jYqftWCn74AerXN8mNt7dTd5+uUiVThBAuJ0cJjlKqlFJqgVLqglLqsFLq4Wu081BKfaaUOqWUilRKLVJKVXBuyEKIwqJP/T54u3uz5sgafjnwi1P2+fXXsGGDeWJqy5Y8TG4AliwxRQjhcnLagzMRuASUBXoBnyqlbs2i3fNAM6A+UB44B3ySRTshhMCvmB+vtjQTcI5bP+6m9/fdd9Cjh3kEPF+MHWuKEMLlZJvgKKWKA92BEVrrWK31WmAh0CeL5lWBpVrrU1rrBGAekFUiJIQQADzV+Cnsys7y/cs5FXvqhvezdy/cf79Z7trVScFlZ+5cU4QQLkdl9/SCUqoRsE5r7ZVh3VCgtdb6nivahgDjgQeA88D/gNNa6xey2G8/oB9A2bJlm8wtZD8kYmNj8c7TvnFxs+QcuY7h24bz29nf6Fe1Hz0rp0/pndNztHlzCQYPTr+LeOnSX3F3T8mTWEVm8v/I9RW2c3THHXf8qbUOya6dWw725Q1EX7EuCvDJou1e4ChwHEgG/gEGZbVTrfUUYApASEiIDgsLy0EoBUd4eDiF7TMVNnKOXMdr5V/j7q/uZtm5ZUzqPQm7zQ7k7Bx17AhLl6bXf/wR2rf/Tx5Gm8GiReb1nnuu364Qk/9Hrq+onqOc3IMTC/hesc4XiMmi7UTAA/AHigPzgZ9vJkAhROHX8ZaOVCtZjUPnD/Hdzu9yvF1SUubkJjoaOnfOgwCv5cMPTRFCuJycJDh7ADelVI0M6xoA27No2xCYobWO1FpfxNxgfJtSqvTNhyqEKKzsNjsv3G6uZL++8vUcD/zn5pY+zt4//4BPVv3Keenbb50woZUQIi9km+BorS9gemLeUkoVV0q1ALoCWY1utRHoq5TyU0o5gIHACa31GWcGLYQofJ5s/CRli5dlb+ReFu5emG37xYvN6/DhZmC/unXzOMCslC5tihDC5eT0MfGBgCdwGvgKGKC13q6UaqWUis3QbiiQgLkXJwLoBHRzYrxCiELK0+HJa61eA+CFpS9w4dKFLNtFR5uB/O6+GyZPzs8IszB/vilCCJeTk5uM0VpHAvdmsX4N5ibk1PpZzDg5QgiRawNCBjDt72lsObWFCX9M4HZuz/T+7t1Qq1Z6Pd/Gu7mW//s/83rffdbGIYS4ikzVIIRwGQ67g9FtzE01k/+cTIrO/Kh3xuTmnXdgxIj8jC4LP/xgihDC5UiCI4RwKR1v6Uh5n/IcPH+QrVFb09YPH57e5ptv4NVXLQjuSn5+pgghXI4kOEIIl+Jmc6NPfTNQ+vzjV9/fUrJk+ojFlps3zxQhhMuRBEcI4XKeve1ZPN08WXNmDb/sD+f0aZPUTJwIZ89aHV0Gn35qihDC5UiCI4RwORV8K/BCUzMuTttXJxIaCu7uMHCgeYLKZfz0kylCCJcjCY4QwiUNum0QNu0Gdb7jyIXd7N9vdURZ8PIyRQjhciTBEUK4pINby5Oy9SFQmsaDPqJLF6sjysLs2aYIIVyOJDhCCJeTnAwtWwJrzMB/u9xnE5UQZW1QWfnf/0wRQrgcSXCEEC7HLXUI0jO1aVquFXGJcczf6YIjBi9fbooQwuVIgiOEcFl9+hyiX+hjALyz9h2SU5ItjugKDocpQgiXIwmOEMJlfP+9eUrq++9hyRJ4/PFD9GnQh2olq7Evch8zNs+wOsTMZswwRQjhciTBEUK4jG6Xp+adMAE6dDDLbjY3RrYeCcD7v72P1tqi6LIgCY4QLksSHCGES8g4IPC772Z+r2fdngR6B7Ln7B5+OfhL/gZ2PeHhpgghXI4kOEIIy/3xBzz0kFnu3h1CQjK/77A7eLLRkwBM+GNCPkcnhCiIJMERQlgqORluv90s+/pee2qngaEDcbe7s3D3Qraf3p5/AV7P1KmmCCFcjiQ4QghL9eiRvrxqFdjtWbcr51OOvvX7otFM/nNy/gSXHZlsUwiXJQmOEMJSH31kXp95Bho3vn7bp0OeBmD65umuMfDfihWmCCFcjiQ4QghLVa4MSUnmyansNCnfhP8E/YfYS7F8/vfneR+cEKLAkgRHCGGJSpWgZ0/Q+tqXpbIypNkQAD5c/yEJSQl5FF0OTZpkihDC5UiCI4TId6tWwbFjMHcu/Ptv7ra9u+bd1CtTjxMxJ/j8L4t7cRYtMkUI4XIkwRFC5KuUFOjYMb1evnzutrcpGyP+MwKA11e9TmR8pBOjy6WffzZFCOFyJMERQuSr8ePh0iWzfOHCje3jvtr3cXuF2zmfcJ5317yb/QZCiCJHEhwhRL45dy59lOI+fcDL68b2Y7fZea/tewBM2DiBnRE7nRRhLo0fb4oQwuVIgiOEyDeBgRARAaGhNz+FU+sqrXmkwSMkJCXw5uo3nRJfrv3yiylCCJcjCY4QIl+cOZN+aWrmTLA54afP6DajsSs73+74lmPRx25+h7m1cKEpQgiXIwmOECJflC4NR46YKzq1aztnnxV9K9K1VleSdTJzt811zk6FEIWCJDhCiHxTqRI895xz99m3fl/ATMKZmJzo3J1nZ9w4U4QQLkcSHCFEnrv7bqhTB+Ljnb/ve4LvIdg/mMNRh5m3PZ/nhVq/3hQhhMuRBEcIkafOnIHFi2HnTti1y/n7tykbQ5sPBWDcb+NI0SnOP8i1fPedKUIIlyMJjhAiT31+ebDhdu2gUaO8OUaPW3sQ4BXAllNbWLxncd4cRAhRoEiCI4TIM6dOwSuvmOXnn8+74/h4+PBKS3OgYcuH5d+9OGPHmiKEcDmS4Agh8kzGKRk6dcrbYw0IGUCQXxC7z+7mnTXv5O3BUm3ebIoQwuVIgiOEyBNnz6b/7v/yS1Aqb4/n6fBkYqeJALy37r38GRdn7lxThBAuRxIcIUSe+Pbb9OWePfPnmJ1rdub+OvcTnxTPsOXD8uegQgiX5JaTRkqpUsDnQHvgDPCq1vrLa7RtDHwMNAYuAO9orWWyFiGKmH79IDgYihfP3+N+0O4DftzzI3O3zeWZ0GdoWbll3h3s7bfN64gReXeMIiY6OprTp0+TmJjPYxoVYn5+fuzcadF8bbngcDgoU6YMvr6+TtlfjhIcYCJwCSgLNAQWK6W2aK23Z2yklCoNLAEGA98C7kBFp0QqhChQlIKwsPw/bpUSVXjutud4/7f3GbZ8GOseX4dN5VFn9e7debPfIio6OppTp05RoUIFPD09UXl9XbOIiImJwcfHx+owrktrTXx8PMePHwdwSpKT7f96pVRxoDswQmsdq7VeCywE+mTR/EVgqdZ6jtb6otY6Rmvt+mmjEMJpTp40j4MfOWJdDIObDcbf058Nxzbw0vKX8u5As2ebIpzi9OnTVKhQAS8vL0luihilFF5eXlSoUIHTp087Z59a6+wO2ghYp7X2yrBuKNBaa33PFW1XAv8AocAtwO/AM1rrq37UKaX6Af0AypYt22RuIbtRLzY2Fm9vb6vDENch5yhv/O9/VZkzJ4jQ0Ejef3/rTe3rZs7R72d/55Vtr2DDxqeNP6WmT82bikVkzZn/j/z8/KhevbokN06WnJyM3W63Oowc0Vqzf/9+oqKirtnmjjvu+FNrHZLdvnJyicobiL5iXRSQVX9XRcy9N+0wic77wFdAiysbaq2nAFMAQkJCdJgVfdl5KDw8nML2mQobOUfOd/YszJljlt94o9RNf31v5hyFEcYxz2NM2DiBz099TnjHcDwdnjcVz1XeeMO8vvWWc/dbgDjz/9HOnTuddv+FSFcQLlFlVKxYMRo5YVTQnFyYjgWu/I7zBWKyaBsPLNBab9RaJwBvAs2VUn43F6YQoiBITW5KlDDzT1ltVNgoKvlW4o/jf/Dm6jedf4CjR00RQricnCQ4ewA3pVSNDOsaANuzaLsVyHjN6/rXv4QQhUrqaMUffmhtHKn8vfyZd7+ZgHPSxklEJVy72/uGTJ9uihDC5WSb4GitLwDzgbeUUsWVUi2ArsCsLJpPB7oppRoqpRzACGCt1trJP1WEEK7mr7/Slx9+2Lo4rtSsUjPuqHIHMZdi+HC9i2ReosiYMWMGSqm04uPjQ4MGDZgwYQJJSUn5FseoUaNyfW9TWFhYgb6Mn9NnJwcCnsBpzD01A7TW25VSrZRSsamNtNYrgdeAxZfb3gK40I86IURemTzZvHbpAsWKWRvLlUa2HgnA++ve5+C5g87b8auvmiJENr6yqrsxAAAgAElEQVT55hvWr1/Pd999x2233cazzz7LW/l479aTTz7J+vXrc7XNpEmTmDRpUh5FlPdyNA6O1joSuDeL9WswNyFnXPcp8KlTohNCFBjDhpnE5umnrY7kaq2rtKZbrW4s2LWAD377gEmdnfRD++xZ5+xHFHoNGzbklltuAaB9+/bs27eP8ePHZ5nkaK1JTEzE3d3dacevWLEiFSvmbli6OnXqOO34VpCpGoQQTnHLLTB+PNSubXUkWRvZeiR2ZeezTZ+x7fQ25+x0yhRThMil0NDQtFGbq1SpQu/evZk2bRq1atXC3d2dxYsXAxAXF8fLL79M1apVcXd3p2rVqowZM4aUlJRM+4uIiGDgwIFUqlQJDw8PKlWqRJ8+fbh48SKQ9SWq8ePHU7t2bTw9PSlZsiQhISEsWLAg7f2sLlHt3r2bbt26UaJECTw9PWnatClLlizJ1Cb1WHv37qVz5854e3sTFBTEW2+9dVXceSmnIxkLIUSWUofScvWhSxoENmBAyAAmbJzAC0teYEXfFVaHJIqwgwcPYrfb08YQWrVqFZs3b2bkyJGUKVOGKlWqkJSURIcOHdixYwcjRoygXr16bNiwgbfffpvIyEg+vHw3/7lz52jevDmRkZG8/vrr1K9fn9OnT/PDDz9w6dKlLI8/Z84chgwZwhtvvEGrVq2Ij49n69atREZGXjPmEydO0LJlS3x8fJgwYQJ+fn5MnDiRzp078+OPP3LXXXdlat+tWzcee+wxBg8ezKJFixg5ciSVKlXisccec9JXMRtaa8tLkyZNdGGzatUqq0MQ2ZBz5Bzr12sdHKz1Z585f9/OPkenY0/rEmNLaEah5++Yf/M7HDLElCLMmedox44d13zPpNJZl8mT09tNnnz9thk1bnztdk89ld5u06Yb/0zTp0/XgN61a5dOTEzUkZGR+rPPPtM2m0137dpVa611UFCQ9vT01P/++2+mbb/44gsN6NWrV2daP3r0aO1wOPSpU6e01lqPGDFC22w2/ddff2UZQ3R0tB45cqQmwxfgmWee0Y0aNbpu7K1bt9atW7dOqw8ZMkTb7Xa9d+/etHVJSUm6Zs2amfaVeqxp06Zl2l/dunV1u3btrntMra//faC11sAmnYPcQi5RCSFuyowZZkqmvXutjiR7AcUDeCvM3PPw8oqXSU5JvrkdxsebIkQ2atWqhcPhoFSpUgwcOJBevXoxbdq0tPebNm1KYGBgpm2WLFlCUFAQzZs3JykpKa20b9+exMRENmzYAMCyZcsIDQ3N1eB4oaGhbN68mWeffZYVK1YQFxeX7Ta//vorTZs2TbuXCMBut9OzZ082b95MdHTmMYE7d+6cqV63bl2O5OMcLnKJSghxwyIiYOZMs/zoo5aGkmMDQgfw0YaP2Bu5lx92/8B9te+78Z1NnOi8wMR1ZTOrUJp+/UzJiT//zFm7Jk1y1u56FixYQMWKFfHx8SEoKIhiVzxqWK5cuau2OX36NIcPH8bhcGS5z7OXb3I/e/YsDRo0yFU8ffv2JSEhgc8//5xJkybhcDjo1KkTH330EVWqVMlym8jIyCyTqMDAQLTWnDt3LtNI1KVKlcrUzsPDg4SEhFzFeTMkwRFC3LBp0yAhAdq2hbp1rY4mZ9xsbgxpNoRnf36WF5e+SMdbOuLl8Mp+QyFuQt26dTP1fFwpqzFq/P39qVq1Kl9//XWW26QmIqVLl06bhTunlFL079+f/v37c+7cOZYtW8aQIUPo0aMHv//+e5bblCpVipMnT161/uTJkyilKFmyZK5iyGtyiUoIccNSJ9IeNMjaOHLrqcZPUbt0bQ5HHebFpS/e+I5eeMEUIfJAx44dOXr0KN7e3oSEhFxVSpcuDZjHzv/44w+2bNlyQ8cpWbIkPXr04MEHH2Tbtms/Ydi6dWs2bNjAoUOH0tYlJyczb948GjVq5HLziEkPjhDihmzdCtu2QcmScMXDEy7Pw82DL7t/SejUUCb/OZkuwV3oVKOT1WEJkUmvXr2YPn06d955J0OGDKFBgwZcunSJ/fv3s3DhQr7//nu8vLwYPHgwX375JW3btuX111+nXr16nDlzhh9++IHPPvssy33369cPHx8fmjVrRpkyZdizZw+zZs2iffv214xn8ODBzJgxg3bt2vHmm2/i6+vLpEmT2LNnT9pj7a5EEhwhxA1JnVizZ09w4nhk+aZhYENeb/U6o1aP4sWlL9K2Wlvc7bn8IB9/nDfBCQE4HA6WLl3K2LFjmTJlCgcPHqR48eJUr16dzp07pw0EWKJECdatW8frr7/O2LFjOXv2LGXLlqVNmza4u7tn+ah4ixYtmD59OrNmzSIqKory5cvTu3dv3nzz2pPSli9fnrVr1/Lyyy8zYMAALl68SMOGDVm8eDEdO3bMs6/DjVI6p3du5aGQkBC9adMmq8NwqvDw8AI9h0dRIOfo5iQlwYoVUL061KiRffsbkdfnKC4xjloTanE0+ihj2ozhtVav5dmxCitnnqOdO3dS21VHiizAYmJi8PHxsTqMHMvu+0Ap9afWOiS7/cg9OEKIG+LmBh075l1ykx+8HF5M72pmAx/962iOROXyEdZnnjFFCOFyJMERQuRaPj7pmefurHYnPW7tQXxSPC8syeUNw56epgghXI4kOEKIXImKgsBA6N7dXKYqDD5s/yHFHcVZsGsBX2/P+pHcLI0bZ4oQwuVIgiOEyJXvvjNJztmz5jJVYVDBtwJj244FYODigcReirU4IiHEzZIERwiRK6lj3/TpY20czvZM6DM0q9iMs/FnGbB4QM42ys2wuUKIfCUJjhAix44ehfBw8PAwl6gKE6UUH3f8GHe7O7O3zuaHXT9kv5G/vylCCJcjCY4QIse+/NLMCdSlC5QoYXU0zndbhdsYe6e5VPX4wsc5dP7Q9Td4911ThBAuRxIcIUSOaA2zZpnl3r2tjSUvPd/0eTrV6ERkfCSdv+xMVEKU1SEJIW6AJDhCiBzZtw927DBXZFxw0FKnsSkbs7vNpqZ/TXZE7KDfj/245oCojz1mihDC5UiCI4TIkRo14PBhc5mqIE7NkBslPUuyoMcCirkV4+vtX/PyipezblipkilCCJcjCY4QIscqVYLrzMVXqNQJqMOX930JwLjfxrHpRBbTybz1lilCXMOMGTNQSqUVd3d3qlevzmuvvUaCxSNmVqlShUcffTStnhprxtnCCzJJcIQQ2TpwAFavtjqK/NetdjcGNx2MRvPEwidISCpEQziLfPXNN9+wfv16Fi9eTIcOHXj33XcZNmyY1WEVapLgCCGydccdEBYGv/5qdST5b1TYKKqXrM7WU1t59PtHM9+P07t34b7jWjhNw4YNadq0Ke3atWPSpEm0bduWadOmkZKSYnVohZYkOEKI6/rrLzhyeQ7KOnWsjcUKvh6+fNX9K3zcfZi3fR7zd85PfzM42BQhcqlx48bExcVx5syZtHUHDx6kV69eBAQE4OHhQcOGDVmwYMFV227ZsoVu3brh7++Pp6cnwcHBvJthuIJly5bRqVMnypUrh5eXF7fffjsffvghycnJ+fLZXEUhGWhdCJFXUi/R9+sHpUtbGoplQiuEMrrNaJ5f8jxDlw+lffX2+Hj4wIgRVocmCqhDhw7h5+eH/+WBIo8ePcrtt99OmTJl+O9//0tAQADz5s2je/fufP/993Tp0gWAP/74g7CwMG655Rb++9//UrFiRfbu3cvWrVvT9n3gwAHuvPNOnn32WYoVK8a6desYNWoUERERjB071pLPawVJcIQQ15SUBP/8Y5a7dbM2FqsNCBnAzC0z+evfvxi2fBif3f2Z1SEVGepNZXUIAOiR1xguIAeSk5NJSkoiJiaGBQsW8N133/Hxxx9jt9sBGDVqFFprVq9enZb0dOjQgaNHj/LGG2+kJThDhw7F39+fDRs24OXlBUCbNm0yHevpp59Oj1lrGjZsiFKKcePG8c4772CzFY2LN0XjUwohbsiqVea1VCno0MHaWKzmsDuY3nU6CsXkPyez+tBqeOghU4TIRq1atXA4HJQqVYonnniC/v37M2jQoLT3lyxZQqdOnfDz8yMpKSmtdOjQgS1bthAdHU1cXBzr1q2jV69eaclNVv7991/69+9PUFAQ7u7ulCpVitdff53z589z+vTp/Pi4LkF6cIQQ1/TGG+Z14EBQrvFHtKXql63PwNCBTNw4kZkvdaDFUnfcomNgwwYYMwZ69bI6xELpZnpOXMWCBQuoWLEiERERfPTRR0yaNInbb7+dvn37AnD69Gm++OILvvjiiyy3P3v2LO7u7qSkpFCxYsVrHiclJYUuXbpw4sQJRo0aRa1atUhJSWH58uWMGTPG8kfT85MkOEKILGltfm+D/N7O6OOOH3PLz3/w1PcbcUu8aFYePpw+q7h8sUQW6tatyy233AKYS0r169dn2LBhdO/eneLFi+Pv70+rVq14+eWsB5UsX748ycnJ2Gw2jh8/fs3j7N+/n02bNjFr1ix6X37CLyYmhpUrVzr/Q7k417hEtXs3zJhhlhMTzfOos2ebelycqc+bZ+pRUaY+//KTDGfOmPqiRaZ+8qSpL1li6kePmvqKFaZ+4ICppw7qsXu3qf/2m6lv22bqGzea+ubNpr55s6lv3Gjq27aZ+m+/mfru3aa+ejWEhVHsxAlTX7HCvH/0qKkvWWLqJ0+a+qJFpp56J/38+aYedXn+m3nzTD0uztRnzzb1xERTnzHD1FNNnQpt26bXJ02Cu+5Kr48fb2ZKTDVuXOZpoceOzdzl/vbbmR+DfeONzEPTv/pq+g92gKFD4Zln0usvvGBKqmeeMW1S9etn9pHqscfSuw3AHPvtt9PrDz1kYkzVvbv5DKm6dDGfMdVdd5mvQaq2bc3XKFVYWKH73uPAAVO/ye899fU8Tt8axvDBcdSqhSXfe7XHjEmvu8j3npvNjed+OEnxRDKLi4PhwxEiOx4eHnzwwQecPn2aSZd/PnXs2JGtW7dy6623EhISclXx8PDAy8uLli1bMnv2bOLj47Pcd9zl3xUOhyNtXWJiInPmzMn7D+ZipAdHCHFNAaVh9Giro3A9tmPHsn4j9Xl6IbLRpUsXQkND+fDDDxk0aBBvvfUWt912G//5z38YNGgQVapU4dy5c2zbto0DBw4wbdo0AMaNG0fr1q1p1qwZQ4YMoWLFihw4cIDNmzfzySefULt2bYKCghg+fDh2ux2Hw8G4jH8EFiVaa8tLkyZNdGGzatUqq0MQ2ZBzdG1//qn11Klap6RYG4fLnqOgIK3NVbxMJbFSBasjy3fOPEc7duxw2r5cxfTp0zWg9+7de9V7S5cu1YD+6KOPtNZaHz16VD/xxBO6fPny2uFw6MDAQN22bVs9a9asTNv99ddf+u6779Z+fn66WLFiOjg4WI8dOzbt/b///lu3aNFCe3p66goVKuiXXnpJT506VQP64MGDae2CgoL0I488clWsGdtYIbvvA2CTzkFuofS1ZsnNRyEhIXrTpizmeSnAwsPDCcvYfS9cjpyja+vWDb7/Ht57D156ybo4XPYczZljLnGlXjoGLjhgav9Qnvu/DdiUa1z9zw/OPEc7d+6kdu3aTtmXSBcTE4OPj4/VYeRYdt8HSqk/tdYh2e2n6PwvFELkyJ49JrkB6NPH2lhcVq9eMGUKBAWBUiRWLM+gex0MLr2RQT8NwhX+cBSiqJMERwiRSep9vXffDeXKWRuLS+vVC+rXh7vvxnH0OH3eW4KH3YNPN33KxI0TrY5OiCIvRwmOUqqUUmqBUuqCUuqwUurhbNq7K6V2KqWucSeeEMIVxcbCwoVmecAAa2MpEO680xSgTdU2/K/L/wAYsmwIaw6vsTIyIYq8nPbgTAQuAWWBXsCnSqlbr9N+GBBxk7EJIfLZ7Nlw/jw0bw6dOlkdTQHw/POmXNa7fm8GhAzgUvIl7vv6Ps7Fn7MwOCGKtmwTHKVUcaA7MEJrHau1XgssBLK8Oq+Uqgr0Bt7N6n0hhOtKHURVem9u3PiO42kU2IgzcWe4/5v7iUqIsjokIYqkbJ+iUko1AtZprb0yrBsKtNZa35NF+x+Bz4FzwGytdZZjSiul+gH9AMqWLdtk7ty5N/whXFFsbCze3t5WhyGuQ85RZsnJiokTq7NuXWlmzPgDT88Uq0Ny+XNU7/Kos/+8916m9Tujd/LKP68QnRRN9eLV+aTRJ3jaPa0IMc858xz5+flRvXp1lMwL4lTJyclpk3q6Oq01+/fvJyrq2n8Y3HHHHTl6iionA/15A9FXrIsCrnrmTCnVDbBrrRcopcKut1Ot9RRgCpjHxF3yUdCb4LKPt4o0co6uduedkJICNtt/rA4FKADn6JFHAK6KMYwwOrTqQIfZHdgXuY8JpyYw/8H5eLh5WBBk3nLmOdq3bx9ubm7XnUhS5F5Bekw8Li4OHx8fGjVqdNP7ysk9OLGA7xXrfIGYjCsuX8p6H3jupqMSQljGJs9W5tzAgaZkoVrJavzw0A+ULFaSn/b+xBMLn5DHx7NRpkwZjh8/TlxcnHytihitNXFxcRw/fpwyZco4ZZ856cHZA7gppWporfdeXtcA2H5FuxpAFWDN5e5Fd8BPKXUSaKq1PuSUiIUQTjdzJiQlmSefixWzOprCo05AHX7p+wutprdizj9zaFyuMS82e9HqsFyWr6/5W/rEiRMkJl452Ze4UQkJCRQrAP+xHQ4HZcuWTfs+uFnZJjha6wtKqfnAW0qpJ4GGQFeg+RVNtwGVMtSbAxOAxsgTVUK4rIQEM+fkv/9CxYrQoYPVERUgqZOLpk6omoVG5RrxeZfPeei7h3hp+UuULV6WXvVlxvFr8fX1ddovOGGEh4c75ZJPQZPTyTYHAtOA08BZYIDWertSqhXws9baW2udBJxM3UApFQmkaK1PZrlHIYRL+Owzk9w0bAjt21sdTQHTo0fOmtXtwY6IHbz161v0XtAbd7s7D9z6QB4HJ0TRlqMER2sdCdybxfo1mJuQs9omHMjyCSohhGu4eNHMNwXw9tsgD6/k0lNP5bjpm3e8icPuYMSqETw8/2ECvQNpFdQqD4MTomiT2wmFKMK+/BJOnjQzDnTubHU0hd9rrV6jd/3eJKUk0XVuV3af2W11SEIUWpLgCFFEJSXBBx+Y5RdflN6bGxIWZkoO2ZSNGV1n0DW4K+cSztF+dnv2nt2b/YZCiFyTBEeIImr2bNi5E6pWhZ49rY6mgHr0UVNywW6zM/PemTQp14QjUUdoPKUx/5z6J0/CE6Ioy+lNxkKIQubhh82YN2XKgLu71dEUULlMblL5FfNjae+l3DvvXtYeWUunLzvxS99fqOlf07nxCVGESQ+OEEWUuzv07QsdO1odSQGWmGjKDfD38md5n+U0r9ScY9HHaDOzDTsidjg5QCGKLklwhChiEhLg2DGroygk2rUz5QYVcyvG0t5LaVqxKcdjjtPs82asP7reiQEKUXRJgiNEETNxItSoYV7FTXrySVNugre7N7/0/YWuwV2JvhhNnwV9OBt31kkBClF0SYIjRBESE2PGvUlIMDcXi5vUu7cpN8nL4cW8++dRJ6AO+8/t595595KckuyEAIUouiTBEaII+egjiIiAZs3grrusjqYQiIszxQk83DxY2nsp5bzLsfbIWvot6idJjhA3QRIcIYqIkydh3Diz/N57Mu6NU3TqZIqTVPStyJfdv8TTzZNpm6fxwDcPkJSS5LT9C1GUSIIjRBExYgTExkKXLtBKZghwjgEDTHGisCphLOy5ED8PPxbsWsBzPz+H1tqpxxCiKJAER4giYMsW+PxzcHOD99+3OppCpEePHE+4mRttq7VlUc9FuNnc+HTTpzz787OS5AiRS5LgCFEEuLmZ8W4GDoTgYKujKUSiokzJA62CWjGj6wwAJm6cyJBlQ/LkOEIUVjKSsRBFwK23wk8/QbLcs+pcXbua1/DwPNl9r/q98HDz4IFvHuC/G/5Laa/SvNryVZTcQCVEtqQHR4hCLCEBMl7ZsNuti6VQeu45U/LQ/XXuZ+a9M1Eohq8czvjfx+fp8YQoLCTBEaIQe+YZaNMG9u2zOpJC6r77TMljfRv0Zco9UwAYvHQwU/+cmufHFKKgk0tUQhRSv/4K06aZOadSUqyOppA6c8a8li6d54d6svGTxFyM4cVlL9Lvx37YbXYeb/R4nh9XiIJKEhwhCqFLl8wNxQCvvgo1ZZLqvHH//eY1j+7BudLgZoNJ1skMWz6MJxc+STG3Yjxc7+F8ObYQBY0kOEIUQqNGwfbtcMst8PLLVkdTiA3J/yebhjYfSkJSAiNWjeDR7x+ldunaNCrXKN/jEMLVyT04QhQyS5bA2LFgs8H06eDpaXVEhdg995iSz4a3Gk6ver1ITEmk05edOB59PN9jEMLVSYIjRCFy6hQ8/LB5cmrUKGjZ0uqICrmTJ03JZ0oppt4zlZaVW3Iy9iT1P6vP+qPr8z0OIVyZJDhCFCIBAfDKK6ZTYfhwq6MpAh56yBQLeDo8mf/gfGr61yQyPpLm05rzzfZvLIlFCFckCY4QhYjNBi+9BN9/b5ZFHnvlFVMsElA8gH8G/MOjDR8F4Lklz3EyNv97lIRwRfIjUIhC4IcfYOPG9LokN/mkY0dTLORud+fzLp/TuFxjTsaepNOcTiQmJ1oakxCuQH4MClHAHTwITz0FHTqYJ6dEPjp61BSL2ZSN+Q/Op5x3Of4++Tdd53YlLjHO6rCEsJQkOEIUYFFR0KkTRESAj49MpJnv+vQxxQUElQji6we+xs/Dj5/3/czTPz5tdUhCWErGwRGigIqLgxIlzPKtt8K6dWbWcJGPXn/d6ggyaVm5JYt6LqLNF22YtXUWvh6+jO84HrtNJiETRY/04AhRACUnw+OXR+n39YWFC8HPz9qYiqS2bU1xIa2CWjHnvjm4292ZuHEiXed2JSEpweqwhMh3kuAIUQA99xzMm2eWFy2CatWsjafIOnDAFBfz4K0P8tPDP+Hr4cvivYtpMqUJJ2JOWB2WEPlKEhwhCqCwMCheHFavhv/8x+poirDHH0/vSnMxd1a7k/BHwqnpX5MdETtoMa0Fe8/utTosIfKNJDhCFEAPPAD79klyY7k33zTFRTUq14g1j62haomqHDp/iObTmnPgnOv1OAmRFyTBEaIASE42l6XWrk1fFxhoXTzistatTXFhZYqXYeNTG2lRqQVn4s5w5xd3ciTqiNVhCZHnJMERwsXFxcGDD8Inn0CPHpAg94u6jt27TXFx/l7+fPvgt9QtU5dD5w/x2A+PobW2Oiwh8pQkOEK4sH374LbbYP5885TUvHlQrJjVUYk0/fubUgAEegeysu9KSnmWYuXBlQxbPkySHFGo5SjBUUqVUkotUEpdUEodVko9fI12w5RS25RSMUqpg0qpYc4NV4iiY9EiCA01oxMHB5txbmR2cBfzzjumFBABxQP44t4vcNgcfLj+Q8asGWN1SELkmZz24EwELgFlgV7Ap0qpW7Nop4C+QEmgIzBIKWXNVLtCFGDjx0PXrnD+vHnduNEM5idcTPPmphQgnWt2ZvZ9s1EoRqwawasrXpWeHFEoZZvgKKWKA92BEVrrWK31WmAhcNX45Frr97XWf2mtk7TWu4EfgBbODlqIwq5BA7DbYcwYWLDATMMgXNC2baYUMA/e+iAz752JTdkYu24s3eZ1IyohyuqwhHAqlV3mrpRqBKzTWntlWDcUaK21vuc62yngL2Cy1vqzLN7vB/QDKFu2bJO5c+fe2CdwUbGxsXh7e1sdhrgOVzpHWsOWLX40bJj+S+bkSQ8CAy9aGJX1XOkcZaXhCy8AsPnjjy2O5MasjljNO7ve4VLKJSp5VuL9+u8TWCx3j+e5+jkShe8c3XHHHX9qrUOya5eTBKcV8I3WOjDDuqeAXlrrsOts9yZwL3Cb1vq6P6VDQkL0pk2bsou1QAkPDycsLMzqMMR1uMo52rkTBg6E8HD45Rdo08bqiFyHq5yja9q40byGhlobx03Ye3YvXeZ2YdeZXVTwqcDyPsupHVA7x9u7/DkShe4cKaVylODk5B6cWMD3inW+QMx1Dj4Icy9O5+ySGyGKqosX4Y03oH59k9wEBJhHwkUBEhpaoJMbgBr+NVjz2BpaVm7J8ZjjtJ7Rmp0RO60OS4iblpMEZw/gppSqkWFdA2B7Vo2VUo8DrwB3aq2P3XyIQhQ+S5ea+2zefhuSkuCpp2DHDrj7bqsjE7myebMpBVxpr9Is7b2U1kGtiYiLIHRqKPO2zbM6LCFuSrYJjtb6AjAfeEspVVwp1QLoCsy6sq1SqhfwDtBOay3jgQuRhalToWNHMz5ccDD8+itMmQKlS1sdmci1F14wpRDwcnjx/UPfc1/t+7iQeIGHvnuIEStHkJySbHVoQtyQnD4mPhDwBE4DXwEDtNbblVKtlFKxGdqNBvyBjUqp2MvlqhuMhShqIiLSl++/38z+/d57sGULtGplXVziJn38sSmFRIliJfj2gW/5oN0H2JSN0WtG0+nLTsQlyrVTUfC45aSR1joSc8PwlevXAN4Z6lWdF5oQBVtCghmBePJk2LsXDhwwoxCXLGl6b9xy9L9PuLSGDa2OwOmUUgxtPpSGgQ3pOrcry/Yv4/6v72dBjwV4uHlYHZ4QOSZTNQjhZAcPwvDhULky9OplLkFduABbt6a3keSmkNi4Mf1JqkKmbbW2hD8STinPUvy872fazWrHvzH/Wh2WEDkmCY4QThIVBe3bm8tP77xjLks1bAiTJsHRo2ZOKVHIDBtmSiEVWiGUVY+sIsArgDVH1tBociOW7V9mdVhC5IgkOELcoOho+Pnn9LqvLxw/bi5D9e4Na9fCX3/BgAHmPVEITZhgSiFWv2x9tjy9hdsq3MapC6foMLsDT//4tIx8LFyedJQLkUNam3tpli6FxYth5UpITDQzflevDkrBnDkQFGTus9w+cyUAABYQSURBVBFFQN26VkeQL8r5lGPtY2sZs2YM7659l8l/TmbRnkXM6jYLm/ydLFyUfGcKkY0zZ0wvTPXq5rHu554zSU5yMrRoAefOpbdt2FCSmyLlt99MKQIcdgejwkax6alNNK3YlBMxJ7jnq3vYGS2DAgrXJAmOEBmkpMCmTfD11+nrvL1h5kxz83CpUtCjB0yfDv/+ay5DhWQ7YLgotF57zZQipF7Zeqx9bC2PNHiEuMQ4Xt32KttOF7wJR0XhJ5eoRJF2/jz88Qds2ADr15vX8+fN7N3duoHDYe6pmToVatSAJk3MLN9CAGYMgCLIbrMz9Z6pnIw9ydL9S2k8uTFj245lcNPBmHmWhbCeJDiiyDh71twzE3h52tiVKwO4446r21WpYp6GiokxPTZgHvcW4irBwVZHYBmH3cE3D3xDuynt+D3yd4YsG8KqQ6uY1mUaAcUDrA5PCElwROETHW0G0tu505StW82IwcePw/PPpw88W6VKHO7u0Lgx3H47NG8OTZua8WuEyJHVq81r69bWxmERHw8fxtYbS2TZSJ5Y+AQ/7vmRWhNrMbjpYIY2H0oxt2JWhyiKMElwRIEUHw+HDpnRgffuhYEDwd3dvNepE6xbd/U2Xl6mBydVlSoXiIlJ306IXBs50ryGh1sahtXuq30foeVD6ft9X8IPhTNi1QjmbpvL++3e565b7pLLVsISkuAIl6O1eXIpJQXKljXrdu2CN9+EI0dMYnPiROZtOnaEWrXMcqNGphenVi2oUwfq1YP69c1TULYMt9XbbJLciJs0bZrVEbiMSn6VWNl3JT/v+5kBiwewPWI7nb/sTJfgLszuNhsfDx+rQxRFjCQ4It8kJprRfcuVM2PGgHk6acsWk7CkluPHzTxOTz1lZtkGuHQJ5s5N35ebmxlvplo1k7hkTFQ++ST/PpMo4qpVszoCl6KUolONTmwbsI3/bvgvY9aMYeHuhQR+GMjkuyfTq14v6c0R+UYSHHFDEhLM+C+RkaaUL28SDTCj906aZHphIiLSy/nz5v3z58HPzyzPmgW//HL1/kuUyPy0UvXq8MUX5v6YKlWgQgWZz0m4gBUrzGvbttbG4WJ8PHx4o/UbdK7RmZ7f9WRv5F76LOjDtL+nMabNGJpVamZ1iKIIkF8RRYDW5p6V2FjzZFBAQPrUAdu2mbkCY2LS34+NNcXNzTwenapZM9i/38y5dOlS5mOMGAFvvWWWT56Ezz+/Og6bDUqXNtunJjiPPQYdOpgEKbVUqGDGnsmoeHHo08c5Xw8hnGb0aPMqCU6WmpRvwu5Bu5m0cRLDVw5n1aFVNJ/WnPtq38dH7T/6//buPzqK8t7j+PubsNlAfhEChJ+i/LpY0HDVaosUqaWgp7ZobQW5eEqP1d5b9ByKbbE91nJtvaK96qnVY2vVyxWqaC1UrKCNCootUKgordwSQQMGEkQghF8BAs/945mQzbJJNj/Ibjaf1znPmdlnnmf2ycwO82XmmXkY1H1QopsoKUwBTjtyDmpq/LT2lsrhw76j7NGj/qpIdPryl+uCkSVL4J13fH50+eHD6wKM/fv9U0GRAcvJk3XtePZZuO46P79sGcyZE7u92dn1A5w9e/yVGPDvh8nP96mgwAcmtYqK/K2lggIf0PTqBb17+7JpUa+W1OPX0qEtWJDoFiQ9M2PmxTOZOmoq9/35Ph5Z9wiL/28xy95fxu2X3s6PPvcjQumhRDdTUlBSBDi1VxhOnKhLNTV+2rWrv10Bvsy2baeXqU2jR/v/6YN/NPijj05fZ02NP/FeeaUvV1MDDz3k+4ccP+4/184fPw7TpsGnP+3LLl8O8+f7qxfHj/tp7XxaGqxaVfc3zZ5dRHl5/TLHjvm/ddYsePBBX279+safMN20qS7AWbwYFi6MXW7MmLoAJzPTPyYdKTPTv7wuO7v+rZ2iIpgxw+dnZ9eVycnxKdLrr/vAJi8PwuG6fjTR+vf3/WdEUt7AgYluQYdR0K2Ae794L7decivfL/4+i/6xiLlvzGXltpX87uu/o2e3noluoqSYpAhwNm3yj/DGMnNm3WC9Gzb4sX8asnGjf2IG4IEHfAfWWD7zmboA5+RJuO22htd5/vl1Ac7WrfVf4R8puj/I/v0hKipOL5eW5oOtWnl5/kmfzEyfwuG6+czM+tvlmmt8X5TacuGwDwC7dq172gj81aFNm+qCleigJtKkST7FY8CA+MqJdBovv+ynV1yR2HZ0IANyB/DMtc/w7Qu/zfW/v56VpSu58LELmT95Pp8/J8abN0VaKCkCnLQ0f7JOT69LXbr4aeRVhKwsfysmukxtCofryp5/vg9iYpUdPryuXCjkr6iEQrHTxRfXlZ04EZ55xgcQGRl+eeR8pPvu28iYMWNOrScc9tPo1/wXFcF778W3nb76VZ+aYgbnnhvfOkWkFebN81MFOM02/uzxrL9pPV9Z9BXeLn+by5+6nJ99/mfMGTuHLmlJcWqSDi4pfkXnnutv1TSlqOj0Wy8NmT3bp6aY1d0uasrw4fWDo8YUFByjb9/4yopIBxX57gJptv65/Xlzxpt895Xv8pu3f8MdK+7g4XUPs+qbqxjaY2iimycdnEYTFxFpqT596gY3kxbJysjisS8/xuLrFpORnkHFwQrOe/Q8flD8A/Ye2Zvo5kkHpgBHRKSlXnzRJ2m1a869hl3f28WUkVOorqnm53/5Oef84hxuXXYrr33wGidOnmh6JSIRFOCIiLTU/ff7JG2ie2Z3Fn1tEetuWseEwROoOlrFw+seZsKCCQz95VCe3PAkldWViW6mdBAKcEREWur5532SNnVRv4sovqGYVd9cxZxL5zA4fzCllaXcuPRGet7Xk5uW3kT5gfJEN1OSnAIcEZGW6tnTJzkjxp41lnkT5lFySwlPXf0UF/f3j7U+vuFxhjw0hCc3aLBTaZgCHBGRllq82Cc5o9LT0rmh6AbWfmstf73pr1w94mqO1BzhxqU3MnHBRIq3Fie6iZKEFOCIiLTUQw/5JO3mgr4XsGTKEn591a/pFupG8QfFTFw4kQsfu5C737ybsqqyRDdRkoQCHBGRlnrhBZ+k3d184c1sn7Wdu8bfRVYoi7fL3+aOFXcw+BeDmbhgIg+ufpC/7/o7J93JplcmKSkpXvQnItIh5eUlugWdWkG3An582Y+5bcxtLN28lAUbF7D8/eUUf1BM8Qf+tlXvrN58qtenmDJyCtPOm0ZuODfBrZb2ogBHRKSlnn3WT6dMSWw7OrluoW5MHTWVqaOmsvvQbl7Z+govb3mZN7e9yUdVH/HxoY9ZWbqSuSvnMvPTMxl71lguGXAJ3UINDIIoKUEBjohISz36qJ8qwEkavbJ6Mf386Uw/fzrOOVaXrWZN2Rqee+851u5Yy50r7wQglBbion4XcUHfCxg3aBxfOOcLFHQrSHDrpS0pwBERaallyxLdAmmEmTFm4BjGDBzDrM/M4sXNL/LqB6/y54/+zLu73mV12WpWl63mkXWPADC0x1BG9BxBUWERo/uMZuxZY+mTraE4OioFOCIiLdVNtzg6ijRLY/KIyUweMRmA/dX7WVO2hjVla3jp/Zf4W/nf2LJ3C1v2buGPJX88Va97ZnfO630ehdmF5GfmMyB3AH2z+9Inuw/DC4YzpMcQjX6epLRXRERaauFCP50+PbHtkGbLy8xj0tBJTBo6iZ+M/wnVNdVs2buFTbs3saF8A0tLllKyp4TK6kpWbV/V4Hoy0jPol9OPwqxCBuYNZFDeIIb1GMbg/MEMKxjGoLxBmFk7/mVSSwGOiEhLPf64nyrA6fAyu2QyqvcoRvUexXUjr+OeCfdQc7KGbZXb2LpvK/uO7GPPkT3sqNpB+cFyyqrK2LxnM9v3b6e0spTSylLW7lh72npDaSF6ZfWiZ7eeFBUWMW7QOIoKi+iV1YveWb3V0fkMUoAjItJSxXqDbirrktaFIT2GMKTHkAbLHDp2iIqDFZQfLD8V7JTsKaG0spRNuzex+/Budh7Yyc4DO9m4ayMLNi6oV98w+uX0o3tmd/K75tM9s7ufz8wnPzOfoT2G0j+3/6m8wuxCBUVxiivAMbMewBPAROAT4IfOuadjlDNgHvCtIOtx4HbnnGub5oqIJJFQKNEtkATLyshqNAg6cvwInxz+hJ0HdvLW9rdYX76eTbs3sXHXRgAcjh0HdrDjwI64vzM3nEvf7L70zenrpxHz3TO7E+4SJpwePjXdfng7H+77kK6hrhR0LSCU3jl+t/FewXkEOAYUAqOBl8zsXefce1HlbgauBooABxQDHwK/apvmiogkkfnz/XTGjES2QpJY11BXBuYNZGDeQC4ZcEm9Zc45Dh47SGV1Jfuq91FZXennj/j53Yd3U7KnhI8PfXyqTMXBCqqOVlF1tIrNezbH35B1dbOZXTLJSM8gIz2DcHrYT7uET+XVplBaiFB6KOZ8rLw0SzuVzMxPsXqfY+U1p0yaxT8AQ5MBjpllAdcCo5xzB4G3zGwpcANwe1TxbwD3O+fKgrr3AzehAEdEUpECHGkFMyMnnENOOIeBeQPjquOcY1/1PsoPlFN+sPy06YFjBzhac5SjJ46emu6r2kd6OJ1Dxw6x98heqmuqqa6pPsN/XeLFcwVnOFDjnCuJyHsXuCxG2ZHBsshyI2Ot1Mxuxl/xAThoZs0IRTuEnvjbeZK8tI+SX8fYR537KZmOsY86t1TbR4PiKRRPgJMNVEXl7QdyGii7P6pctplZdD8c59xjwGPxNLIjMrP1zrmLEt0OaZj2UfLTPkp+2kfJr7Puo3huZh0EokcnywUOxFE2FzioTsYiIiLSnuIJcEqALmY2LCKvCIjuYEyQVxRHOREREZEzpskAxzl3CFgM3GVmWWZ2KTAZWBCj+FPAbDPrb2b9gNuA+W3Y3o4kZW+/pRDto+SnfZT8tI+SX6fcRxbP3aPgPThPAl8E9uDfbfO0mX0OWO6cyw7KGXAv9d+DM0e3qERERKQ9xRXgiIiIiHQk8b8xR0RERKSDUIAjIiIiKUcBTpzMbJiZVZvZwqj8aWa2zcwOmdkfgv5Ktct6mNmSYNk2M5vWVnXFM7OwmT0RbKMDZvaOmV0ZVeYLZvZPMztsZivMbFBU/SfNrMrMKsxsdlvVlZbT7//Ma+rY0XGTPGKdf3TuiYNzTimOBPwJWAUsjMgbiX8f0Dj8Sw6fBhZFLH8GeDZYNhb/4sORra2rVG+/ZAFzgbPxAftVwXY9O1jeM9h2XwcygZ8DayLq3xPs13zgXKACuKK1dZVavV/1+z/z27jBY0fHTXKl6POPzj1xbrdEN6AjJGAq8Fzwj0FkgPNfwNMRn4fgByXNCf7xOAYMj1i+AJjX2rpKTe6vjcC1wfzNwF8ilmUBR4ARweedwMSI5T+tPdhbU1epVftPv//EbfuN+LEHddwkSYp1/tG5J76kW1RNMLNc4C4g1mXUemNvOee2Evw4aHgMr5FtUFcaYGaF+O1X+4LJ6O18CNgKjDSzfKAvDY+f1pq60nL6/SdA1LGj4yYJNHL+0bknDvGMRdXZ/RR4wjlXZqcPqBc99hbUjdN1gsbH8GpNXYnBzELAb4H/dc79M8jOBnZHFa3dltkRn6OXtbautFxzxr+TNhB97JiZjpvk0ND5R+eeOHTqKzhmttLMXAPpLTMbDUwAHmxgFY2N09XUGF6tqdtpNLWPIsql4S+lHgNuiVhFU9sZTh8/Ld591FhdaTn9/ttRA8eOjpsEa+L8o3NPHDp1gOOcG++cswbSWGA8vsPddjOrAL4HXGtmbwerqDf2lpkNBsL48buaGsOrNXU7jTj2Ue0btJ8ACvF9b45HrCJ6O2fh7zm/55zbB5TT8PhprakrLafffztp5NjRcZN442n4/KNzTzwS3QkomRPQDegTkf4beB7oFSwfib+c9zl856yF1O+NvgjfIz0LuJTTe7K3qK7SafvpV8AaIDvGsl7BtrsW/0THvdR/omMe8Ab+iY4R+H98r2htXaVW71P9/ttnO8c8dnTcJD41dv7RuSfObZjoBnSkRNRTVEHeNGA7cAh4AegRsawH8Idg2XZgWlvVVTq1nQYBDqjGX16tTf8WUWYC8E/8kxwrCR4hD5aF8eOsVQG7gNlR629xXaVW7Vf9/s/8Nm702NFxk1wp+vyjc0/TSWNRiYiISMrp1H1wREREJDUpwBEREZGUowBHREREUo4CHBEREUk5CnBEREQk5SjAERERkZSjAEekE2tkGIzIVBqUnW9mZQluMgBmNjdoW5uMp1e7vjjKjQ++d3xbfK+InDkabFOkc/ts1Ocl+NGD50bkHW231oiItBEFOCKdmHNuTeRnMzsKfBKd31pmFnbOKVASkXajW1Qi0ixm9q9mtsrMDpvZ+2b271HLZwS3ccaZ2e/MrBJYG7H8MjN7zcwOmNkhM3vFzEZFrWOSmf3FzPab2UEz22xmd8Zozjlm9lJQZpuZ3RmMjh25rn8xsyVmVmlmR8xsjZldEcff2cvMnjazqqDuU0D3Zm0sEUkYBTgi0hy5wNP4AfomA+uAR83s8zHK/hb4EPgacDuAmX0JeA0/5tF0/Jg4OcAqMxsYlBkMLA3qTgG+AjyAH/wv2hLgdeBq/Pg5/wl8o3ahmfUD3sKPiHwLcB1QCbxkZlc28bcuBq4CfhS0owb4ZRN1RCRJ6BaViDRHDvAd59wKADN7E5gEXA+siCr7vHPuB1F5vwDecM5Nrs0wsxXAB8BtwCzgAiAD+A/nXFVQ7PUG2nO/c+5/gvlXzezyoC21ebPxo1Z/1jm3Jfi+ZcAm4G5geayVmtkXgbHA9c65RUH2K2a2HBjQQFtEJInoCo6INMfh2uAGIOhXUwKcFaPsksgPZjYMGAL81sy61CbgMLAaGBcUfQc4Diwys6+ZWe9G2vNS1Od/RLVlHLCmNrgJ2nwCeAYYbWa5Daz3s8AJ4PdR+YtilBWRJKQAR0SaY1+MvKNAZoz88qjPtYHKE/gAJjJdBRQABMHIJPy/TwuAiqDfzGUxvmNvE23pEaMdABWA4a/uxNIX2OecOx6Vv6uB8iKSZHSLSkTOlOj3yuwJpj8EXo1R/tipiv4q0QozCwOXAnfh+82c7Zz7pBlt2Av0iZHfJ2hfrIANfFCUb2ahqCCnsBnfLSIJpABHRNrLZqAUGOmcmxdPheAW2Otmlg28AJwDNCfAeQOYFQRGpQBmlo7vNLwhoo9PtNVAOnAt9W9LTW3Gd4tIAinAEZF24ZxzZjYTeMHMMoDn8MFKITAG2O6ceyB47HwcsAz4COiJv+qzE9/HpjkeBGYAxWb2E6AK+A4wHPhSI20tNrO3gF+bWU/gfXxQNKqhOiKSXNQHR0TajXNuGT54yQIeB14B7sPfMlodFHs3WH4P8CfgYfwj45c754408/t24p+Geg94FHge3y/nS865l5uo/lV8kHUP8Cz+P4S3NOf7RSRxzLkmh18RERER6VB0BUdERERSjgIcERERSTkKcERERCTlKMARERGRlKMAR0RERFKOAhwRERFJOQpwREREJOUowBEREZGU8/9nVrDy0eSydgAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 576x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "def plot_precision_recall_vs_threshold(precisions, recalls, thresholds):\n",
    "    plt.plot(thresholds, precisions[:-1], \"b--\", label=\"Precision\", linewidth=2)\n",
    "    plt.plot(thresholds, recalls[:-1], \"g-\", label=\"Recall\", linewidth=2)\n",
    "    plt.legend(loc=\"center right\", fontsize=16) # Not shown in the book\n",
    "    plt.xlabel(\"Threshold\", fontsize=16)        # Not shown\n",
    "    plt.grid(True)                              # Not shown\n",
    "    plt.axis([-50000, 50000, 0, 1])             # Not shown\n",
    "\n",
    "plt.figure(figsize=(8, 4))                      # Not shown\n",
    "plot_precision_recall_vs_threshold(precisions, recalls, thresholds)\n",
    "plt.plot([7813, 7813], [0., 0.9], \"r:\")         # Not shown\n",
    "plt.plot([-50000, 7813], [0.9, 0.9], \"r:\")      # Not shown\n",
    "plt.plot([-50000, 7813], [0.4368, 0.4368], \"r:\")# Not shown\n",
    "plt.plot([7813], [0.9], \"ro\")                   # Not shown\n",
    "plt.plot([7813], [0.4368], \"ro\")                # Not shown\n",
    "save_fig(\"precision_recall_vs_threshold_plot\")  # Not shown\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "True"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "(y_train_pred == (y_scores > 0)).all()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure precision_vs_recall_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 576x432 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "def plot_precision_vs_recall(precisions, recalls):\n",
    "    plt.plot(recalls, precisions, \"b-\", linewidth=2)\n",
    "    plt.xlabel(\"Recall\", fontsize=16)\n",
    "    plt.ylabel(\"Precision\", fontsize=16)\n",
    "    plt.axis([0, 1, 0, 1])\n",
    "    plt.grid(True)\n",
    "\n",
    "plt.figure(figsize=(8, 6))\n",
    "plot_precision_vs_recall(precisions, recalls)\n",
    "plt.plot([0.4368, 0.4368], [0., 0.9], \"r:\")\n",
    "plt.plot([0.0, 0.4368], [0.9, 0.9], \"r:\")\n",
    "plt.plot([0.4368], [0.9], \"ro\")\n",
    "save_fig(\"precision_vs_recall_plot\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {},
   "outputs": [],
   "source": [
    "threshold_90_precision = thresholds[np.argmax(precisions >= 0.90)]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "7816.1555236825225"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "threshold_90_precision"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_train_pred_90 = (y_scores >= threshold_90_precision)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9000380083618396"
      ]
     },
     "execution_count": 42,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "precision_score(y_train_5, y_train_pred_90)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.4368197749492714"
      ]
     },
     "execution_count": 43,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "recall_score(y_train_5, y_train_pred_90)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# ROC curves"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.metrics import roc_curve\n",
    "\n",
    "fpr, tpr, thresholds = roc_curve(y_train_5, y_scores)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure roc_curve_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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pEqKZIIDwH33hR1BUtasWcPAgQNZunQpI0aMwDmnXhsREZEDFMkExww47riww0jYn/70J4YNG4Zzjqeffprzzz8/7JBERESqtEheRWUYLFniS4ZbvXo1AwYMoE2bNixfvlzJjYiISApEsgcHgBtu8F8zdA7Ohg0baNasGUcddRR//vOfOeWUU6hRo0bYYYmIiERCJHtwMOChh3zJMM45HnroIVq0aMG8efMA6Natm5IbERGRFIpkD44BtG4ddhjfs3nzZoYNG8YzzzzDGWecwQknnBB2SCIiIpEUyR4cM4M33/QlQyxdupR27drx/PPPM2nSJObOncshhxwSdlgiIiKRFMkeHABuucV/zZA5OCtWrMDMWLRoET//+c/DDkdERCTSIpngGMBjj4UdBuvXr2flypV0796dSy+9lEGDBlGvXr2wwxIREYm8aCY4Bhx1VKgxvPbaawwZMgTwN/GrU6eOkhsREZE0ieQcHABef92XNNuzZw/XX389PXr0oGnTpixYsIA6deqkPQ4REZHqLJo9OBhMmOAfdO+etvMWFRXRrVs33nnnHS677DKmTJmi5EZERCQE0UxwDHjiibSfNzc3l9NOO41rrrmG/v37p/38IiIi4kV3iOrww32pZDt27GD48OEsW7YMgNtvv13JjYiISMgimeAYwLx5vlSiDz74gJNOOomHHnqIt956q1LPJSIiIomL5BAVBvzud/77Hj1SfviS5RauuuoqGjRowPz58+mexrk+IiIiUrZIJjiGwezZlXb8WbNmMXz4cM4880ymT5+uOxKLiIhkmEgmOAA0b57yQ+7YsYM6depwwQUXUFxcTH5+PllZkRzlExERqdIi+elsBrz0ki8pUFxczMSJEznmmGPYuHEjNWrUYMiQIUpuREREMlQke3AM4M47/YNzzqnQsdatW0d+fj4LFizgwgsvpEaNGhWOT0RERCpXJBMcAJ55psKHmDt3LgUFBRQWFvLoo48ydOhQv1K5iIiIZLRIJjhmBk0aV+gYzjnuv/9+mjdvzuzZszn22GNTFJ2IiIhUtogmOMCcOf7Beeclte9nn31GzZo1Ofzww5kxYwa5ubnk5uamPkgRERGpNNGdJTt1qi9JeOqppzjhhBMYPnw4AI0aNVJyIyIiUgVFswcH4IUXEq6/fft2Ro4cyWOPPUanTp24//77Ky02ERERqXzRTHAMaNAgobqfffYZZ599NqtWreLGG2/k1ltvJScnkm+LiIhItRHRT3KDP/7Rf3vhhWXWbNasGc2aNeP+++/n9NNPT0NsIiIiUtmiOwfngQd8KcWmTZsYPXo0RUVF1K9fn4ULFyq5ERERiZBI9uCYAa++WupzixYtYuDAgaxfv56zzjqL7t276942IiIiERPJHhwDqFPHl0BxcTETJkygS5cu1KhRg8WLF2sFcBERkYiKZIIDwMyZvgRGjRrF2LFjycvLY9myZXTo0CHE4ERERKQyRXSIyuDRRwEoHjCA7Oxsfv3rX3PiiSdSUFCgISkREZGIi2QPjgG7X3mFa9u1Y+DAgTjnOProo7nooouU3IiIiFQDaU9wzKyRmT1nZtvN7J9mNnA/9czMJpnZ10GZZAlmJ//6fDWdunRh8j330LRpU4qLi1P7IkRERCSjhTFEdT+wGzgEaAe8YmYrnHMfxtW7FOgDtAUc8GdgDfBgWQcvLtpG3llduMjt46ErruDEe+9N+QsQERGRzJbWHhwzqwv0A8Y65wqdc4uAF4HBpVQvAO50zn3hnPsSuBO4qLxzFG/9D62P/Sl3Hn88J37wQQqjFxERkaoi3T04RwN7nXMfx2xbAXQppe5Pgudi6/2ktIOa2aX4Hh+AXcvefXtl7rdPVihgqbAmwMawg5D/UntkFrVHZlF7ZJbWFdk53QlOPWBr3LYtQP391N0SV6+emZlzzsVWdM49DDwMYGbvOedOSl3IUhFqj8yi9sgsao/MovbILGb2XkX2T/ck40LgoLhtBwHbEqh7EFAYn9yIiIiIxEt3gvMxkGNmrWK2tQXiJxgTbGubQD0RERGR70hrguOc2w7MAcabWV0z6wz0Bp4opfoM4Goz+6GZHQqMBh5P4DQPpypeSQm1R2ZRe2QWtUdmUXtklgq1h6V7xMfMGgGPAb8EvgbGOOdmmdmpwFznXL2gngGTgEuCXR8FrtcQlYiIiJQn7QmOiIiISGWL5FINIiIiUr0pwREREZHIqZIJTjrWs5LEJdEe15rZSjPbZmZrzOzadMdaHSTaHjH1a5rZR2b2RbpirC6SaQsza29mfzWzQjP7t5ldmc5Yq4Mk/lbVMrMHg3bYZGYvmdkP0x1v1JnZFWb2npntMrPHy6l7lZmtN7OtZvaYmdUq7/hVMsHhu+tZDQIeMLPS7nIcu57V8cA5wGXpCrIaSbQ9DBgCHAz0AK4ws7y0RVl9JNoeJa4F/pOOwKqhhNrCzJoA84CHgMZAS2B+GuOsLhL93bgS6Ij/3DgU+AbQwoap9xUwAX/h0X6Z2ZnAGOAXwI+Ao4Bx5R28yk0yDtaz+gY4rmTJBzN7AvjSOTcmru4S4PHgTseY2cXAMOfcyWkOO7KSaY9S9p2K/xn8deVHWj0k2x5m1gJ4FbgaeMQ5d1g6442yJP9WTQQOd86Vti6fpECS7fEAsM05d13wuBcwxTlXoaUDpHRmNgE4zDl30X6enwV87py7IXj8C+BJ51zzso5bFXtw9reeVWlZeMLrWckBS6Y9/isYKjwV3bwx1ZJtj3uBG4Ciyg6sGkqmLU4GNpnZEjPbEAyJHJGWKKuPZNrjD0BnMzvUzOrge3vmpiFGKV1pn+WHmFnjsnaqiglOStazqqTYqqNk2iPWrfifv2mVEFN1lnB7mFlfINs591w6AquGkvndOAwowA+NHAGsAZ6q1Oiqn2Ta4xNgLfBlsM8xwPhKjU7KUtpnOZTzOVMVExytZ5VZkmkPwE8sw8/F6eWc21WJsVVHCbVH0F1/OzAyTXFVR8n8bhQBzznn3nXO7cTPL+hkZg0qOcbqJJn2uB+ohZ8PVRd/B3714ISntM9yKONzBqpmgqP1rDJLMu2BmQ0lmCzmnNNVO6mXaHu0Ao4E3jKz9fg/4D8IrlI4Mg1xVgfJ/G68D8T+46V/wlIvmfZoh5+/uSn4J+xe4GfBZHBJv9I+y//tnPu6rJ2qXIKTpvWsJEHJtIeZDQImAr90zq1Ob6TVQxLtsRI4HP+HvB1+SZR/B9+vTV/E0ZXk36ppQF8za2dmNYCxwCLn3JZS6soBSLI93gWGmFmDoD1GAF855zamL+LoM7McM6sNZAPZZlbbzHJKqToDuNjMjjWzhsBNJPJZ7pyrcgVoBDwPbAf+BQwMtp+KH4IqqWf4bvhNQbmd4MoxlVDaYw2wB9/dWFIeDDv+qJVE2yNun67AF2HHHrWSTFsAw/FzPr4BXsJfVRX6a4hSSeJvVWPgSWADsBlYBPws7PijVvBzMV1cuRU/D60QOCKm7tX4f8K24v8hqFXe8avcZeIiIiIi5alyQ1QiIiIi5VGCIyIiIpGjBEdEREQiRwmOiIiIRI4SHBEREYkcJTgiIiISOUpwRDKImV1kZm4/pXuSx7ok2C8tK4Sb2YS4eL8xs3fMLK8SzpUTnOOmmG3nmdmoUup2D+qekuo4yoivZdx7UWxm68zsCTP74QEes72Z3Rrc6ExEylHaHQNFJHznA/FLWfw9jEAOQMfga2PgMuApM6vpnJuRqhM45/aaWUe+e9fl84BTgLvjqv9vEFMYy7RMAF7Br2vUEbgZaGNmHZ1ze5M8VnvgFvwdXDenMkiRKFKCI5KZljvnPg07iAPhnFta8r2ZzQdWAaPwt1uvlPOUU28rkFDdSvBZTJxvmlkt/J1a2wHvhRSTSLWgISqRKsbMcs3sHjP70My2B0MfL5pZ6wT2HWxmy4P9tpjZ+2Z2SVydbma2wMwKgzLXzI49kFidc3uA5UDLmOM3MLPfB3HvNrNVZnZlXAwHmdl9ZrbWzHaZ2b/N7M9mdnTw/HeGqMxsJjAI+FHMsNCnwXPfGaIys4fM7Cszy447Z+3gPbkzZluzmPq7zewjM7v4QN6LwP8Pvh4Rd+4JZrbMzLaa2UYze8PMfhbz/CXAI8HDNTGv8bCY9+PG4L3cZWZfmtkdQUIlUi2pB0ckM2XHLTrnnHPFwfe5QRkPrMcPBV0OvG1mbZxzG0o7oJl1Babjh3BG4xe4OxY4OKZOb/yChC8AA/H/BI3Brzp+vHPuywN4LS0IhlSCpGIucDx+QckPgXOBu82ssXPu5mCfe4AewI3Ap8FrPBVosJ9z3AI0wa8y3DfYtnM/dZ8ALgV+AcyP2d4bOIigpymY67IYqIEfWvoc6Ak8Egy5PZDQq/+uI4Ovn8VtPxS4Ez8sWQ8owL/nJzjn/o5vj6OA3+CH4tYF+5W09VPAWcDv8L1VP8H/fBwBXHgAcYpUfWEvtqWiovJtAS7i+4vPOfzK0vvbJxuoC+wAfh2z/ZJg38OCx2OADWUcx/Af4q/FbW+IX6x2cjmxTwjOlxOUQ4Dbgm2Tgzp9gsf5cfs+jk9IGgWP/wHcXsa5coLj3BSzbSbweSl1uwd1T4l5nauBJ+LqvQy8H/N4HFAE/Diu3jT8on/ZZcTXMjjn0CDWuviE6itgdjnvYzY+qfoMuLOU9jwyrn63YPvAuO0Fwfbjwv65VlEJo2iISiQz9QU6xJTvDIuYWZ6Z/a+ZbQH24lfezQXKGqZ6F2hqZjPMrJeZxfeGtAF+BDwZDHnkBL1IhcA7wGkJxr4nKOuBa4Ep+J4YgmPsBWbH7TMTPxH35zGxXmxmY8zsRDNL2d8q55zD9+L0NbO64IeigDOD7SV6AEuAf8a9H68BzSj7vS7xB/x7UQi8ju+hKYivZGZnmNlCM/sa//7sxvfYJHKOHvjk8Lm4OEt6pxJtN5FIUYIjkplWOufeiymrSp4ws774IYmVwAB8UtAB38tSe38HdM69gR+uOBJ4HthoZvPN7LigSrPg63S+TVJKSg/8MFEiSpKylkB959xo59yu4LlGwEb3/SuI1sc8DzACP+dkGH4y7gYzu9PMchOMoTwz8b0q5wWP8/B/D5+MqdMMOJ3vvxdPBc8n8n6Mw78XXYEHgu/vja0QzLV5BdiC7/E5Oai3kjLaMy7O2vgevNg4v0oiTpHI0RwckaonD/iHc25oyQYzq40fSiqTc+5p4Gkzq4f/8J4EzDWzI4Cvg2rXAX8pZfddpWwr7RxlXR20CWhiZjlxSU7zmOdxzm3DD6mNMbMj8ZfN/xbfU3EjFeSc+8TMlgL5+F6bfOAN59xXMdW+xl+GfvV+DrNqP9tjfR7zfrxpZgcBl5jZg865kgnH/fCvq1/se2JmjfBDYeX5GtiOT6JK89V+totEmhIc+TyImwAAAnNJREFUkaqnDn4YI9YQkuiRdc4VAi+aWUv85NaD8ffZWQsc65y7I0WxxnsTuAr/of7HmO2D8B/y37uc2zn3OXCHmQ0Gjot/PsYu/DBdomYA95pZN3yPyZC45+fh7+PzuXNuYxLHLcv1+Nd+C35SM3zbnq6kkpmdgZ94/FHMviUJZvxrnIefNF7XOfdmiuIUqfKU4IhUPfOA+8xsMv6KpA7AFcDWsnYys//BD1f8BX8VzhHBfu855zYFda4A5gQ9Qn/C9w40BzoBq51z91Qw9peBt/FXIjXHf4CfjZ9cfZtz7psgjnfwV3OtxPdOdMNfGfRQGcf+OzDUzC4FlgFFzrmVZdT/I/6KsieCc8yJe34yvufoLTO7C/gYqI+fq9TJOdeXJDnnvjSzB4Erzaytc24Fvj2vAKaZ2fTg+Dfx/Z6Xkhs9XhFcFr8HWOGce93M/oSfgzMFf2ND8EORPYHRzrn4q7ZEoi/sWc4qKirfFr69iqplGXWygYn4D8Ad+ISlLX4C66Mx9eKvojoXP/F0Hb43YC1+nkvzuON3xs8J+Qbfq7IGP+/k5HJin0Awh7eceg2A3wdx7MYP9VwZV2cyPknZgp+g+z5wRczzpV1FVR+ftHwTPPdpsP07V1HFnee54LkZ+4m1Ef6S9c+DWDcAfyXmarX97FdyFdVFpTzXLHhNz8ZsGxWcowifoHQDFgGvx+07Pmj34ri2zcb3jL0ftNlm/P2HJgEHhf1zraISRjHn/tsrKiIiIhIJuopKREREIkcJjoiIiESOEhwRERGJHCU4IiIiEjlKcERERCRylOCIiIhI5CjBERERkchRgiMiIiKR839arjkviDZ5pgAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 576x432 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "def plot_roc_curve(fpr, tpr, label=None):\n",
    "    plt.plot(fpr, tpr, linewidth=2, label=label)\n",
    "    plt.plot([0, 1], [0, 1], 'k--') # dashed diagonal\n",
    "    plt.axis([0, 1, 0, 1])                                    # Not shown in the book\n",
    "    plt.xlabel('False Positive Rate (Fall-Out)', fontsize=16) # Not shown\n",
    "    plt.ylabel('True Positive Rate (Recall)', fontsize=16)    # Not shown\n",
    "    plt.grid(True)                                            # Not shown\n",
    "\n",
    "plt.figure(figsize=(8, 6))                         # Not shown\n",
    "plot_roc_curve(fpr, tpr)\n",
    "plt.plot([4.837e-3, 4.837e-3], [0., 0.4368], \"r:\") # Not shown\n",
    "plt.plot([0.0, 4.837e-3], [0.4368, 0.4368], \"r:\")  # Not shown\n",
    "plt.plot([4.837e-3], [0.4368], \"ro\")               # Not shown\n",
    "save_fig(\"roc_curve_plot\")                         # Not shown\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9611778893101814"
      ]
     },
     "execution_count": 46,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.metrics import roc_auc_score\n",
    "\n",
    "roc_auc_score(y_train_5, y_scores)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note**: we set `n_estimators=100` to be future-proof since this will be the default value in Scikit-Learn 0.22."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 47,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.ensemble import RandomForestClassifier\n",
    "forest_clf = RandomForestClassifier(n_estimators=100, random_state=42)\n",
    "y_probas_forest = cross_val_predict(forest_clf, X_train, y_train_5, cv=3,\n",
    "                                    method=\"predict_proba\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_scores_forest = y_probas_forest[:, 1] # score = proba of positive class\n",
    "fpr_forest, tpr_forest, thresholds_forest = roc_curve(y_train_5,y_scores_forest)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure roc_curve_comparison_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 576x432 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(8, 6))\n",
    "plt.plot(fpr, tpr, \"b:\", linewidth=2, label=\"SGD\")\n",
    "plot_roc_curve(fpr_forest, tpr_forest, \"Random Forest\")\n",
    "plt.plot([4.837e-3, 4.837e-3], [0., 0.4368], \"r:\")\n",
    "plt.plot([0.0, 4.837e-3], [0.4368, 0.4368], \"r:\")\n",
    "plt.plot([4.837e-3], [0.4368], \"ro\")\n",
    "plt.plot([4.837e-3, 4.837e-3], [0., 0.9487], \"r:\")\n",
    "plt.plot([4.837e-3], [0.9487], \"ro\")\n",
    "plt.grid(True)\n",
    "plt.legend(loc=\"lower right\", fontsize=16)\n",
    "save_fig(\"roc_curve_comparison_plot\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9983436731328145"
      ]
     },
     "execution_count": 50,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "roc_auc_score(y_train_5, y_scores_forest)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9905083315756169"
      ]
     },
     "execution_count": 51,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_train_pred_forest = cross_val_predict(forest_clf, X_train, y_train_5, cv=3)\n",
    "precision_score(y_train_5, y_train_pred_forest)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 52,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.8662608374838591"
      ]
     },
     "execution_count": 52,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "recall_score(y_train_5, y_train_pred_forest)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Multiclass classification"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 53,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([5], dtype=uint8)"
      ]
     },
     "execution_count": 53,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sgd_clf.fit(X_train, y_train) # y_train, not y_train_5\n",
    "sgd_clf.predict([some_digit])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 54,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[-15955.22627845, -38080.96296175, -13326.66694897,\n",
       "           573.52692379, -17680.6846644 ,   2412.53175101,\n",
       "        -25526.86498156, -12290.15704709,  -7946.05205023,\n",
       "        -10631.35888549]])"
      ]
     },
     "execution_count": 54,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "some_digit_scores = sgd_clf.decision_function([some_digit])\n",
    "some_digit_scores"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 55,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "5"
      ]
     },
     "execution_count": 55,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "np.argmax(some_digit_scores)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 56,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9], dtype=uint8)"
      ]
     },
     "execution_count": 56,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sgd_clf.classes_"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 57,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "5"
      ]
     },
     "execution_count": 57,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sgd_clf.classes_[5]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 58,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([5], dtype=uint8)"
      ]
     },
     "execution_count": 58,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.multiclass import OneVsOneClassifier\n",
    "ovo_clf = OneVsOneClassifier(SGDClassifier(max_iter=1000, tol=1e-3, random_state=42))\n",
    "ovo_clf.fit(X_train, y_train)\n",
    "ovo_clf.predict([some_digit])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 59,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "45"
      ]
     },
     "execution_count": 59,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "len(ovo_clf.estimators_)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 60,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([5], dtype=uint8)"
      ]
     },
     "execution_count": 60,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "forest_clf.fit(X_train, y_train)\n",
    "forest_clf.predict([some_digit])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 61,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[0.  , 0.  , 0.01, 0.08, 0.  , 0.9 , 0.  , 0.  , 0.  , 0.01]])"
      ]
     },
     "execution_count": 61,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "forest_clf.predict_proba([some_digit])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 62,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([0.8489802 , 0.87129356, 0.86988048])"
      ]
     },
     "execution_count": 62,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "cross_val_score(sgd_clf, X_train, y_train, cv=3, scoring=\"accuracy\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 63,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([0.89707059, 0.8960948 , 0.90693604])"
      ]
     },
     "execution_count": 63,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.preprocessing import StandardScaler\n",
    "scaler = StandardScaler()\n",
    "X_train_scaled = scaler.fit_transform(X_train.astype(np.float64))\n",
    "cross_val_score(sgd_clf, X_train_scaled, y_train, cv=3, scoring=\"accuracy\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 64,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[5578,    0,   22,    7,    8,   45,   35,    5,  222,    1],\n",
       "       [   0, 6410,   35,   26,    4,   44,    4,    8,  198,   13],\n",
       "       [  28,   27, 5232,  100,   74,   27,   68,   37,  354,   11],\n",
       "       [  23,   18,  115, 5254,    2,  209,   26,   38,  373,   73],\n",
       "       [  11,   14,   45,   12, 5219,   11,   33,   26,  299,  172],\n",
       "       [  26,   16,   31,  173,   54, 4484,   76,   14,  482,   65],\n",
       "       [  31,   17,   45,    2,   42,   98, 5556,    3,  123,    1],\n",
       "       [  20,   10,   53,   27,   50,   13,    3, 5696,  173,  220],\n",
       "       [  17,   64,   47,   91,    3,  125,   24,   11, 5421,   48],\n",
       "       [  24,   18,   29,   67,  116,   39,    1,  174,  329, 5152]])"
      ]
     },
     "execution_count": 64,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_train_pred = cross_val_predict(sgd_clf, X_train_scaled, y_train, cv=3)\n",
    "conf_mx = confusion_matrix(y_train, y_train_pred)\n",
    "conf_mx"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 65,
   "metadata": {},
   "outputs": [],
   "source": [
    "def plot_confusion_matrix(matrix):\n",
    "    \"\"\"If you prefer color and a colorbar\"\"\"\n",
    "    fig = plt.figure(figsize=(8,8))\n",
    "    ax = fig.add_subplot(111)\n",
    "    cax = ax.matshow(matrix)\n",
    "    fig.colorbar(cax)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 66,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure confusion_matrix_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 288x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.matshow(conf_mx, cmap=plt.cm.gray)\n",
    "save_fig(\"confusion_matrix_plot\", tight_layout=False)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 67,
   "metadata": {},
   "outputs": [],
   "source": [
    "row_sums = conf_mx.sum(axis=1, keepdims=True)\n",
    "norm_conf_mx = conf_mx / row_sums"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 68,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure confusion_matrix_errors_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 288x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "np.fill_diagonal(norm_conf_mx, 0)\n",
    "plt.matshow(norm_conf_mx, cmap=plt.cm.gray)\n",
    "save_fig(\"confusion_matrix_errors_plot\", tight_layout=False)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 69,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure error_analysis_digits_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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efJkIDnPG6n7U6ZM4c477wRgx44dAOTL598PHzp0iO+//z4xA4whOs937dqV4JF4/PvvvwBs27aNTz75BIBly5YB8MMPPwBwyimn0LBhQwAaNGiQgFFGl82bNwO462zNmjWAf6464ogjovIapuwYhmEYhpHSpKSyo9VvvXr1XGxdBCog7733HgArV64EPA/CeeedF49hhmXjxo2At2r/5ZdfMlVvwrFz5073eUgJKliwYJRGCWvXrgVgyZIlAFStWpVff/3VvTZ46lTfvn1z/HpSp+rWrQtA2bJlc/w3M6NHjx4sXrwYwP2Uh6V+/foUKlQI8LwAF1xwAQBnnXVWzMaUVfQdzJgxg3feeQfwPAz//PMPQJbPq7///htIfWVn1qxZAIwePZry5cune6xcuXIA3HTTTRmeJ5/L6NGjmT17NuApO/KGJAP6HqVefv/99zz88MMAVK5cGfCu727dunHppZcmYJQ5R9flyy+/DEC7du0SOZwM7Nu3D4B3330XgIEDBwLwxRdfONUt1DX6+uuvA/7rEKBGjRoxH2sodG5Pnz6dN954I8vPX7p0Ka1atQI8Ree+++4DPGUxGpiyYxiGYRhGSpNSys6UKVMAL+7366+/Orf9rbfeCvjVHvDHRe+++24ANm3aBMBzzz0HwKuvvhq3MWeG4rbr1693v9Nuq0OHDpk+TzFoeZQAF/dduHAhEDorIavI4zFz5kwAunfvDsCZZ57p4q/BcfDsKFPByFMghSeWu7QzzzyTo446CvB2X8pWUUYceDus/Pn9l1OVKlU455xzAE8JSlRGnM7tUFlVoly5clStWjXd76RktG3blnvuuQfwdpB5BXn5spp9JC/U6NGjqVixIgBXXHFFVMcWDSZNmgTA1q1bAX9Wp7LwpP698MILADzwwAMJUw5yiq5hqc+JZNu2bYA/AxKgevXq9OvXD4AVK1ZkOF4eLyn8v/32G+D3sugeod8lig8++ADAzXmZoblz6dKlgBdZGTBggFOwXnzxRQD+97//AdG5Z4iUWuxoYaCfxYsXd6mioSabadOmATBhwoT4DDAL6GYjiRCgadOmh33eunXrgPSLnVig8IgWOUIhs6yikNA555zDZ599dtjjteCL5WJn0KBB7kanBXDt2rXd4wpRzJkzB/AWdytWrHATl6RphQOOP/74mI03FApZXn311Rke6927NwAlSpSgTJkyIZ+/c+dO9uzZE7sBphAKPWuxky9fPvcZxzLcml10DQVunnQua64pXbo0AL169Yrv4HKAyijoBqqQyOjRozMcq4WQEg9ijUze/fv3d7/LLFTVoUMHZ3CXtaJHjx6Af7GjBZCOSRQnnXQSAI8//ribx4NZvHgxb7/9NuDZKcSll17qEiFU1iIWWBjLMAzDMIyUJqWUnU6dOgHeDvuee+7JdCe9detW3nrrrXS/k5EtmYhEzQEvpb5r164ZHlMIJZoGw8KFCwPejm/cuHGAP2V1+/bt6Y7V56owIXjy+F133QXAkUceCfhTKmVwFs2aNQO8kEw8ueyyy9L9DERSq4yeSlW+8sornbKjsKJM8CoyFy9OO+00wJOaI0WprnfddVcG+V/hulNOOSUKI8z96LwePnw4AD/++CMAn332GTVr1kzYuCJl+fLlAIwdO9ZdxwpnqcpwMqbMh2LevHnO4KtQe6jwq87h999/H4hfmFnFJfVz3759nHrqqYBnFH/sscfc8Yo66BhRsmRJnnjiCQCOOeaY2A76MNx2220AvPbaa3Tp0iXi5zVu3BiAYcOGuXkqlpiyYxiGYRhGSpNSyo78CZHEl999911n8FKcUIbl3Ih2BcE7+GLFijlfTTR3Z9oZPf744+l+fvzxx3z00UeAF/+XOTzQ4BjO7FiyZMl0/5bqk6yoANuQIUMA+Pbbb91j2sEFtxJIVlSqQbvjQFVHZv8xY8YAqVHMLKds2LDBlVTYsmUL4Cl+v//+e8LGlRV0vaodBOAUKXkwNm7cSKlSpeI/uEyYOnUq4Pmkpk+fDvjT/mWEzYwWLVo4D16823ioVIO8fH/99ZdTroMZPXq0MzLLz6NEgjlz5lCiRIlYDzciVGpjzZo1LpHju+++S3dMx44dXQkSzR9KN4/X/G7KjmEYhmEYKU1KKTvhkAt+wYIFgF8JkdIRqjBYbqJr1658+umnIR+7/fbbo5JqHilXXHGFy3xTJlNWiuxt2bLF7da0ewu1Q050dsvu3btdZsTYsWMBr0gf4JpDqshW9erV4zzCyNm1a5fb3d9+++2A50MC7/tTm5K8rOhIrdT1NmbMGKfoCGV5jhkzhjPPPBPwMmaCr41kQN6JokWLuvcyceJEwPP5lS5dmltuuQWARx991B2fCJ599lmnJEtJiAR5S0aOHJnwxqxXXnllpo9t2LAB8GdeyfMn9UeqiDyTyUShQoWcEqgMrWrVqgGwd+9eLrnkEsDLxpI387TTTouLupPSi51//vmHBx98EPC6FQfekBSKkbFUjyXjiRSIwiZNmjQBwnc9T2RXe32ewX2XAvniiy8Ab2Hz1VdfubpA4XjmmWeiMMLs06ZNGzdmcfTRRwP+iUnmQd3skoG9e/cCXmquFmurVq3KsFjW5FOhQgVXU+j000+P11CTih07drjUZPUVC7zJqv7VVVddle55w4YNc6UYhg0bBnjG/HPPPdd9/jfccEMMR394zjjjjHQ/wUvX1rg//vhj1xNNoXLVSYm3Uf2VV17J0iJHnH322YDfOK7SHgp5JcN1qtR4nRfbtm1zizpZERJtRo4Uhag054BX500/Rbt27Vx9nWhWTA7GwliGYRiGYaQ0aYnc+YchKoMaM2ZMptWGfT5fBjWkQoUKgH/lWbx48WgMIWq89957zuAlI6FkwFDvRXTp0oWhQ4fGZ5D/j/pIyQCujuFSpALRyl9FCsNRsWJFV8hPYaJE7XTOOOMMfv7553S/0443loWxcoIqIT///PNA5sXMwCtCmNWU9cMQvXKoOSfiOaZjx46uYreQEvD+++87464K1Indu3e7sJcqEo8aNco9LmVZ5RekBh533HGRv4s4sWfPHhfGVDq6Eg9Gjx7t3ks8qFu3Lh9++GGO/obm+v379wOeEtG4cWP3WDR7CIZD9yj17pK9YtKkSbk2ZKw+fJrXa9WqleGeKpWzR48eztSv6yMHnc4znWNM2TEMwzAMI7Xx+XzJ+F9U2Lhxo+/000/3nX766b6qVav6qlat6uvWrZuvW7duvs2bN/teeeUV3yuvvOKOyZcvny9fvny+J554IlpDyDEvvPCC74UXXvClpaW58QX/V6FCBV+lSpV8lSpV8hUpUsRXpEgR91jXrl3jOt6ZM2f6ihUr5itWrJgvLS0tKv9VqFDBV6FCBd/q1avj+l7C0b59e99RRx3lO+qoo3z4VQJf5cqVfZUrV/aNHz/et3v3bt/u3bsTPcx03H333b67777bfa4ad6jPvHz58r7y5cv7Xn311WgOIdHzSrbmmDvvvNNdT+3atfO1a9fO9+uvv/p+/fXX7H0KPp/vjTfecOe1voeRI0f6Ro4c6Tt48GC2/248uOOOO3x33HGHG/f48ePj+vq//fabm++iNccE/tepUydfp06dfP/++6/v33//jfn70evqHOvfv7+vf//+MX/dZOHWW29159LcuXN9c+fOzcmfy/SaN2XHMAzDMIyUJqU9O5GiuLoa+AHMnz8fSHy34nvvvRfwl6SXt0LFpOTaDyyGeP311wOe1yLenp3evXu7DIJoobIByZAxEYi699arVw/wWnaAdy4pyyAe5dAPx5QpUwAvG0LXflpamiuyFtypPn/+/K6tShT8A7nSs7Njxw7XVqBFixZRG4CymYIbOY4bN86lSScjymzVGIcNG+Za9cQLnZPffPMNAE899RTgP1/l91DWoTJ85I368ssvXTuXcFldKtSqazhWaHya3+Vtufnmm12bGhV5DG4bkQqsXr3adUxXxpyydJXhmgXMs2MYhmEYRt7ElB28onW1atUC/FlO/fv3B3B1ehKFarksWLDAFXfr2LFjpsdL2dFOtEuXLq5WRjxYs2aNKxWuwmQqjX7nnXe6nYqyINq0aZPhb+ic1K5LzU3VjiHZkCqi2j+qrQL+AmjgZaQla50MqQzKsAnMjlORvCgUwsuVyk6s+O233wBcsTVlV95zzz1xz6DMDioyuHLlSqdyxvv8VtNVKeAPPviga+qpa09KeOvWrd3zVF/n6aefBjyVVtme4KkMq1atitn4wWv2qflDSjZ4c6FatQR+vj179gQ8BSo3ozpWavuxfv16IFuKeKZzjC12AlCV26+//jppFjuRohCKQg1fffUVkJjU85yiFPsqVaoAXvjq7bffdhNQMqJxt27d2n3+YvLkyQA0b9487uPKCvp8165d635ni53Yonln5cqVQO5Z7CiU1KxZMxdO0jUbL1SwVIVhs1uJVyGvyZMnuyri8VrsBKPFzrvvvusWO9owLlq0CPBvBAPD0OCl0/fs2dNdq8leIFdoXtTmPhaLHQtjGYZhGIaR0qR0u4i8hKTMYEUhN1KmTBnAK/Qlmbdp06auC7d6sCQT2gnOmDHDFX5UR2wVDrvhhhsyFJ9LBhTK3bNnT4JHknfQuRxcnDLWJlQpSCpep9YJkaIQp9pHVKxYMct/IzsEhvRnzZoFeL3cZJYObHmRFXr16gX4W1EItbv55ZdfgPj145NCo58A999/P+Alzvz111+uuKOKt0pda926NbVr1wa8wn3xVtySEVN2DMMwDMNIaUzZwd/kDnDG2tzGJ598kmnXcxm/chNqIbF58+Z0v1+7dq2LzSczodIl9Z4WL17sDJTRQl2SS5cuna3nb9myhaZNmwKeSdaILX/99ZdrD6EO8/r+VDo/2sgLctFFFwHw2GOPAZ7R9XBI0VHj0i+//BLwKzzxUCultAwfPtz9Ti0sxo0bB3jdtsHrzl6kSJF0f2fnzp1OcRUyKB84cIBy5coBng8oXm0jIiGwW7o6oetzkbm3c+fOrryEvDD6dzTbIOV03hGbNm1y7SXUKiUWn7kpO4ZhGIZhpDR5WtlR+rPSDeXIB6K++w7FjBkzAP9uukuXLmGPDSwqKJQl8/HHH7vHihUrBvgzlwCX6h1Ndu7cycaNG9P9rkCBAkB0Cv8tX74cgHnz5uX4b8US7XS//vprwCuE9dRTT7ndlr4X7SSjcV79+eefAO6cUYG0Zs2aOe9WuCyGrVu3ArBt2zYA2rZt6/wjQp6omjVrOiXA8Pxj+q4DVYZw6HxQiv8rr7ySocnqG2+8AcSuEahSsaV0PPzwwxE/94svvnBF+ZYtWwZ4qvEDDzwQzWFmC/lq9BOylz1YrVo19x3r+jjxxBNzPL5Yoowr+Zfq1q3rmtNKzVu3bh0QHWVHWWDKWJY/Mbu89NJLrsxIy5YtgegqUCIlFztaxKxevdqdCMHGtf379zsZd9CgQYB3Y2rdujUXXnhhzMZXt25dwJswd+/efdgTZt26dZl2Nk9LS3PyrSTmWCxyxDvvvOMuLKFFVufOnV137axMEmPGjAH8k5W6/waTCHOv6nHIBChj5NSpU13l7d27d2d4nhZ/Dz30EODVAYkGo0ePBrx0dtGnTx9X8+eqq67K9PlaHGmRFnhe6Tzq06cPELoOUl5GtaMWLFgAQKlSpVwdl2CqVavmPmMtMBVaAU/+16I1lnMOeCZ0zY9arIe7sShUVa9ePbZv3w549WB0bqsCcKxRPaKxY8e6G21giYSsoMW8KoYr9Lx582a36Y3Hhjccn3zyiVskZ6V6+dKlS92CRPOl5qNooPCeKkvrc8pqWQ1t1gcPHuzM35p3YoGFsQzDMAzDSGlSsqigjK2lSpVyuxYV6VIlyr59+2Yw9ZYsWRLwp/BJqYgFFStWBNJX2j0cPp+P008/Hci4Sj906BDPPfccANdee22URpk5tWrVYvHixZk+rtRZ9agJREZCnXdSDrZs2QJ4Rt5A1I/oxRdfjGuRrKFDh7o+QOHer9A50717dyehq+p1NJGZUt+5wh9ZNW/rOyhatKgrbKdCcTEKpeT6ooIyFavybjgKFiwYUvUDf4hF/ZyqVq2anaFkGZlApf7qO1cvu5IlSzqlRGneCvGfeuqpLuyu8WamNMcDKTtS5aUmR9qXT8/TNaOwfDJVaR8yZIiLPrRr1w7w98sKRoqd5qrZs2e7806JB+qLFw00b9x5552A9xmOGDEibAVtlVh47bXX3PHgt4/MnTsXIBohcysqaBiGYRhG3iTllZ1MX8Dnc6qP+hYp5TOnqXSHY/z48YBXlGv16tUu7hkuVVyFs4oWLRrT8R2OCRMmZPDsRJOTTz4Z8FJi9b7jperI3N2iRQuncCh2LiPdJZdcwo4dOwAvVt2kSRMgNmpOOLRDWrJkiTNXRoK8F/fff39UY/phyPXKjnax3377LeD3TY0cORLAeVrcCxz34wQAACAASURBVPh8TmmVT0997Y466ijy54+vZVJeFHUoHzt2bLrH09LS3K5dJuabbroJgIEDByZ83slr/P7779SpUwfwDMaBBLeLEA0aNHDnnZSgWBh+5TnVveDEE0/kmmuuCXns559/7ryC8q8pdb5fv34uahEFTNkxDMMwDCNvkpLKjnbhtWrVcs0Zg3nwwQdp2LAh4Ln8jcj477//XPqz4rbihx9+iChD4oILLgDSFwETStNOVIlzKXwXX3yxa/OgrBql1qvUvpElcr2yYxjxROqx/Djyecq3B3D++ecDnopTvXr1kH7JWKGimDfccAOffPJJyGMKFSrklBwp4ddff30shmNdz434sGrVKtejJRxaYMY6ZGgkFbbYMQwjllgYyzAMwzCMvIkpO4ZhxAtTdgzDiCWm7BiGYRiGkTexxY5hGIZhGCmNLXYMwzAMw0hpbLFjGIZhGEZKY4sdwzAMwzBSGlvsGIZhGIaR0thixzAMwzCMlMYWO4ZhGIZhpDS22DEMwzAMI6WxxY5hGIZhGClN/kQPwMjbvPPOOwB89913AMyfP58PPvgg3TFdunQBoGvXrpQrVy6u4xs9ejQAffr0AeCKK64AoFq1aqjVijqjFypUKK5jMwzDj67Tp556it9++y3dY3fccQcAVapUAeC+++6L7+BC8M8//wDQs2dPnnvuOQBKlCgBwJ133glAq1atqFChQmIGmE1mzJgBQPfu3QHIn9+/xBg4cCDXXXddwsYFKd4ba8mSJQwbNsz9P8D3338PQOXKlWnRogXgP+GSDV283377LYC7IAB3k01Ly7zVkI554okn3MVzyimnxGSsWWHjxo0ANG/eHIDly5cDsG/fvsM+t2jRopx88smAtziKJp9//jkAL7zwAgCffPIJW7ZsAeDAgQMZjtdnXLJkSQCefvppANq2bRv1saUI1hsrydFG46233gJg165dAKxbt44///wTgF9++SXdc5o0acKVV14JwN133x2XcWqxcOuttwLeuH0+H5deeikARx11FAAffvghAPv37wfg7bff5oYbbojLODPj999/B6BUqVKZHtOsWTMef/xxwFuoJSOauzt16sSkSZMA2LNnT7pjbrzxRndOxRjrjWUYhmEYRt4kpZQdreA7deoE+HcgWs2HQspI48aNAZg2bVp2XjbHfP755+nUBCAiRSESZSctLc39bSk8iWLjxo00a9YMgC+++CLdY0cccQQA119/PevXrwfg66+/zvA3JIuOGjUK8CTqnDBr1qx0f2vbtm2A/zMM/ozLli0L+M+t4O+hSJEigH9XrJ1ubuCVV17JIP1HylVXXQVArVq1Ijk85ZSdP/74g19//RXw1MZnnnkGgLVr1zqVoUmTJgDce++90XjZqHDw4EHAC9EOGjSIv//+G4CLL74Y8MZdtGhRzjjjDABq1KiR7u888sgjzJ8/H4DVq1fHfuDgQiJz5swB4PTTTwegdevWTg0RkydPBnBKfp8+fXj44YfjMs7M2L17N+D/fKVuC6lp+/bt49RTTwXgwQcfBLx725FHHhmvoR6WJ554AvCHEDU/SuWWBaF8+fJ89tlnQMzHbsqOYRiGYRh5k5RQdqZPnw54O3PtTho1asQjjzwCeDuOunXrArBw4UJuvvlmAAoUKABE5huJBlIOtOqdN29eOjUBMqo2FSpU4IQTTkh3jHYwH3/8MZdffjkA7dq1AzxvTFpamtt1L1iwIDZvKEJatWrFxIkT0/2ufPnygPfdde/e3cWzf/jhB8DbzaxevZpixYoBnuqjnU9O0OcTrDadeuqp7jMuWrQoAOeccw4AK1eu5NNPPwXgxRdfBDwVrl69erzxxhsAFC5cOMfjixZr1qwB4JprrgE89XD//v1kdx6QL0I7+8MoPCmj7Oi7f+CBB1i6dCngXbP6LM8++2w37+ixli1bAjB+/PicvHyOkNo9aNAgADdHdu7c2SkIuq6kpIbiyy+/dM/TebBw4cLYDDqIatWqAZ6X5dlnnwVCe2CWLVsGwAUXXADA1Vdf7RShZOT9998HoFu3bqxatSrdY/IVSnlLBs4++2wAfvzxR+c1vf322wHv+/n222/ZuXMn4CngMcKUHcMwDMMw8iYpkXo+YsQIAI4++mjAS3+77LLL3DEXXnhhuudcdNFFcRpdRrQ6lyL133//ucdKly4NkEFRqFGjRqYqhnbqADfddBMAQ4YMifKoc07fvn1Zu3Yt4GUjDBw4EICGDRu645Q1ph2zjgVPhYuGogOwYsUKNmzYkO53jRo1AsJ7uMqXL+/8Rzrf5Ht57733GDNmDJB4j4Z2hoMGDXKZEnv37o3a35caKo9SNP92MtK7d28AHnvsMcCfLqzv+NFHHwVwCiz4PT3gzTdS1xKJPEbyWrz88suAX10N5wMUmzdvBjxletWqVUyZMiUWQ82UmTNnAp6HLhSLFi0CvDlDtGrVKmbjigbyI40YMSKDspNM6FqQV23UqFFO0dm0aROAy+A7+uijIzq3YklKLHZkwNWHHrjISUYaNGgA+I2h4E0ekP2b47hx4wBPXk9GSpcu7RZ4ItSiRe9Bk5LCkkcccYQLPUaL77//3oUdJHcrVBUpOt9ef/31qI4tGmjBNm3atEwXIk2aNHEp/eKkk04C/KnE27dvB2Dw4MGAt6DR+Qs4I26qormlf//+AC5sPHjwYM4777xMn6fQsSb9wIVQotB5qg3R//73v4iep+tDx//8888AjB071s1p8UKLHC0mtWDbu3cvO3bsALzwskLJnTt3BryyF8mKri+ZmJOVjz76CID69esD6ReR2vgpVH7jjTcmPKRvYSzDMAzDMFKalFB2KlasmO5nJMydO9f9v1Iq441SIXNKv379nIQupFZUrFiRCRMmROV1okEk4aehQ4cCnqIjKlas6IpERouGDRtSp04dAE488cRs/Q0VKAs2XycDCod27NjRKTNSF1SQrXjx4hmk/kC++eYbAM4//3zAC9uBF56JRgmAZEbnpHbbI0eOBOCss87KcKyO6du3r0tDv/HGGwHiVVgtLMGp2eE4dOgQ4B/3XXfdBeCULIWSFHpPBCqn8fbbb2d6jFLs77//fgCOOeaY2A8sC0gFkSIlk6/KkCQrs2fPBryyIfnz53eJNsEp8gp5JhJTdgzDMAzDSGlSQtnJCipY99BDD7l0SaUt5hbU8kIG2XXr1mUwf0nlmj17NmXKlInvALOBCkLWr18/nWE7kEsuuSTqr3vMMcfEZKenXW+iDcqiRIkS9OvXL+LjFY9fsWKFUwJU7CwQnYO33HJLFEaZvEjB0XUWqOjINyI/mlSgtWvXuhRzKTu5BaUJSzl588036dWrF+AZm5MBpZpXqlQJgA0bNmTwuqi1hBSpyy67zH0fer4UiWh7AoXUpZUrVwKeKrJs2TLnhZJxPBwqhlizZk137Sn1Wwk68UL3T5UymD9/vvPx6T0dd9xxgD8FXSphvnyJ0VhM2TEMwzAMI6VJiaKCkbBu3TrAc+KvXLnSZRCo83ayowZ88piE2gkobVqZFsmm6iiNXMqBiu8pPh2oHpx22mkALmX63HPPjfvuJRzaMSq7Rdke4BVsSxZl53AoZVSF4lSUMpSaox3dqFGjnF/p+OOPj+Rlcm1RweAUcmUi/fHHHy4bT2UVrr32WsBfODAZsq8i5Y8//nAZTCoJUbx4cQCGDRvmsm4SnUIcjlWrVjnvi+Z8ZcRpnpeKE4g8a82bN3eemWjNNYcOHXLtE5588smo/M1ArrjiCgBq164N+P1zap8RD5566ing8IqfPIJqQaK2I+GaoWaDTE/OlF/s6KYjCV8poIUKFeKll14CvAVBhP194oLqFPz0008ADB8+3FUN1qQabtKRxNm3b9+EGbBVAVkhjgMHDrib548//pjp83QRqFZNKBNoopkxY4YLV4RK90/mxY6qHauO0fjx493NO3hxc+GFF7qu7pqkVLNK8nkWSKa7ZLbmGPWRUkLASy+9RMeOHQHvelTIIllRmHjx4sUArkZOYFVnvb/bbrsN8Gpf5WYC+wxqLtXiXj9fffVVF3pROY/rr78eyH74Zf/+/Zx55pkAGWp6BVKwYEHAq/QcjmXLlrnNVjClS5d29Xnike6tDeuAAQPcIkulGb799lsAlixZ4jZQ2jjIatGzZ093fBTM7lZB2TAMwzCMvElKKzuzZs1yMnu496kdmRSeLl26cM899wDhe8PEAoVzFI4KtXrPStfzihUrul4r8Q5pydiqSptZRTtmGci180kk2pmVKVMmou9B4TrtXJIBmTODCzwGImWqbdu2bqcbBXK9shMKfZ5Kf9Z58f7777uQVqLZs2ePUyLVAy6whIBQ6EbGZIXhGjVq5Ar5Jbo4XCyQyXbWrFm0bt0a8FTO1157DchZ5WWp8bqvBKLq8TVr1gS8Eg/hWLZsmTNiq6iuvs+9e/c6RXnAgAFA/O9joZCyI8VeZRi++eYbV8R0+PDhgHdNZUNNM2XHMAzDMIy8SUorO998841TSPQ+1TW7bNmyrFixIt3xMgADdO3aFfBUBRVHijVSCUKpBTKinXvuuel+ylwKXuEsGZTT0tJcjxh5YeKFPjut1gNp3749gItlK56uXVUg8hYksp+ZkB+jc+fOzvMVTtkpVKgQ4O3sgtsyJAKZJKUibt++PcO1oHPtzTffpESJEtF66ZRUdv7991/A87dIMStRogR333034PclJJLp06e7wo86B+XBCoU8Lfq5YcMGp+zUq1cP8HyBl19+uSsslwpIgVDHbl3fs2bNSipfZzC6rgNN0CrCmgxF/TKjV69ebpwyl8tj271796z+OVN2DMMwDMPIm6S0shMpKnY0depUwJ+6p3io3OTZyDzJFmo5EJwOf9ttt7kUV6kFoVB8uU2bNoB/V6Kd2KxZs6I93KghxaRx48a8++676R5LJmVHrF+/3qXRBys7L7/8MmPHjgU8RVEZW7EojJhTtm/fnqEIonZYVapUcb+LtGFkGFJS2QlGHrX+/fs734eU1kRl5+3atYu//voL8Eo6RIKaUi5btoyPP/4Y8OYozY0dO3Z0akIUVcCEM2fOHMBr3Ny2bVuXmp+MqBlqhw4d3O+kjPTt2zchY4oUlQOQWqj5snXr1m4ujZC8m3qeHSZMmOAkadUQeOyxxxI5pCwjY1daWpqTXlVvIhlRGKtevXqumrJIxsVOOP7991+Xbq9Fq24wU6ZMcanbyYhMjlos79ixw9XBWL58OZD9HmLkkcWO6NOnjwtfaREgw3oyllOIFHWy1o1/wIAB3HTTTYBnPk3mWjyHQ2FJGZJlPG/fvn1SL3Y0r6ikBHjp87qfJTuq3C07xtixY90cqkXnYbAwlmEYhmEYeZPE56MlIXXr1nVGZiM+KIwVrOokGhl3VXCtaNGiQPjO0ccee6zbmWhXopT1+++/P6kVNhn6FTKdOXOmKwL22WefAf5Qo3F4Hn30UacSqBihkgmWLFmSsHHlFKUJ6xrYvn27S2uXEbZ69epRf12Fjbdt2+bMw9Fm7969TtGR0Vz3gmRVZBV9kJk8kHAm9GRE82u3bt0Av7Ij83KEyk6mmLJjGIZhGEZKY8pOCOKVZh4LQhUKiwXffPMNAFWrVs3W82WAnTZtGhC68OB1110HQLVq1bL1GtFARSl/++03ACZPnhzR81REUAqJDHdJ6pFz7NmzB0hfzPLYY48FolLKPc+hEgsyj65Zs8b9VKduIzwffPAB4PlOgssk5AT5j6QoDxkyxHle5DuS70VzQbIgReeZZ54BvMKIAO3atQO8aze3oZY2AEWKFInK3zRlxzAMwzCMlMaUnRDUr1/fKQ+RlO5OJlQoLlBBiLaaMH78eJfSKPVFsfpKlSq5pnqhUPxVTULVsC6QBx98EPB2xYnsdB5c5PGuu+4C/ErNpZdeCsCpp54KeOXewdt9qjGefDqxyFLZvn074E9rlvfp4YcfBnDqweHKxavooVKjlTVUoEAB7rvvPiD3XQvJgFq0SBX76quvAP91MHLkyISMSard1VdfDXjtI7KKMmcWL17sChVGuYM14CkXSuPPabuKLVu2uEKrUmonTZoE+K9PFU8cNWoU4PdwxoPg9OtChQplKEGiFgu9e/dm9erVQHpFB/xqu9qUZLd5aXbYv3+/U+HUfDrSki1qTqssUL3PAgUKuO8hp6T8YkeTtlKbQ524WgyoVsSXX37JMcccAxAzI1wwujmuW7cO8MxYGkc4PvzwQ7eIULgksN+XzIPRolatWi7c8eqrrwJeeua5557r6nFkBS0YXnjhBbeASoZ+Lr169QK8RZrCd88//zwjRowAvFTscuXKuefJkKxqrLFMxVUNDdVYAnj99dcB2LRpE+DvWv33338Dniy8detWwP+Z6yasPmoK5daoUSOsGdsIj8zdf/75J+CdB4kMYb355puAd0PKKlosaWG8cuVKNw/Eos6Ouo4vXLgQ8G8qVJlapmV10A5E9dO0sFEI8bvvvnPhKy3StLFq2bIltWvXBuJnZ9BmRT2yVGrjyCOPpHjx4umO1YIveIEDnqVg7ty5ca13JGGgatWqbh5X6C8cK1euBGD27NnODC7j/nnnnQf456YclLpIh4WxDMMwDMNIaVK+qKBS2bTKV/pgvXr12LdvH//H3pkH2lh9//+lTFGo0CANKqIylKKSqSgyVBJC0SAhaZCpVIgGSqmvSoYKlTJG8klJhITIVCRDIUTmOX5/nN97P+eee+51hzOf9frncsb9nPM8++z9Xu+1FniSmdSVvHnzunBQpArZPfnkk4BXaVUhg0svvRTwhYlU5VbKiXaJK1asSNUd/ZxzzgF8ikvFihVDPl7trNRxN6Pkzp0b8NI5VXxPVT9jtdiaJGYpWH369HEyvv4GQ9eXdjy9evVyUm2o0O5PFXL9Uapzvnz5XHhR57TOe6kP4O1mVQwvxKpOLFWai8jEp89RqedKyfYv/BZppPQqhPPZZ58BcO6556apQB47dswpJCqwKgWiV69edO7cOWzj/fvvvwFPlV++fLm7rtJTTNN6TPHixZ3yoe9HJReiwapVq4DMq316vI6hUaNGAOTJkyeEozsxOpdr1arlKm4XLlz4hM/TvHPw4EH3O62elPo9zII52YoKGoZhGIaRnCS8siPPjla9io8GQ6rD6NGj3eMjheKXNWrUADKmFvjvWORvadu2LYDrcFyuXLnQDxbPu6Jd4vDhw0/4nGeeecbFlRs3bhyWcUWSRYsWAZ7RM9h3phR0qXLp9TXLLgUKFEil8KWHzpl8+fK586VSpUoANG3aNPQDTBJl57333gN8HhFdH7pW1X8vmsXelBQghU/+uyZNmrj5RyUsVBTx6NGjrqikfIQqtBmpuVIKz7x585g6dWqK++RR03jB88DIlyMlpGXLlhlSHiKF5nN5AKVuBENKf9OmTd1cLxU/2mzYsMH93ioyItatW+fM61KPda5dcMEF7hh0fNnAlB3DMAzDMJKThFd2hPwM8ph89dVXLsVQuy6tqMPhcckoGVELApWdCy+8kO7duwMh6UxtxCk//vijy8YTOp+U7QCeL6pHjx6Al+oaARJa2VFhTHlacuTI4Yq66frU31hgw4YNAEyePBnwZS3JRyEfyeWXXw74PHZSKZUpGiuKgmH4YcqOYRiGYRjJSdIoO4ZhRJ2EVnaknsnD0qhRI+655x4g/hoyGkackuYcY4sdwzAiRUIvdgzDiDoWxjIMwzAMIzmxxY5hGIZhGAmNLXYMwzAMw0hobLFjGIZhGEZCY4sdwzAMwzASGlvsGIZhGIaR0NhixzAMwzCMhMYWO4ZhGIZhJDQ5oz0AwzCMRKR79+58+eWXAFx99dUANG/eHPD13ytQoEDUxmYYyYYpO4ZhGIZhJDQJ3S5i/Pjx/P33374XDOgUDjBt2jQAJk6cCMDpp58OwIsvvui6h+fOnTsUQ8k2wY5lzZo1ALz22mvpPveLL74AvG7FkWbs2LEAHDhwwN329ttvA9C+fftU/y9YsCAA9evXj+Qwk47169cDMGvWLFq0aAF4HbvVwTsYNWrUAODzzz/njDPOyMxbJlW7iAMHDrB69WoAPv74YwC++uord9+NN94IwMsvvwyQ2c/SSALWrl0LwE033ZTi/wBjxowBoHHjxpEfWOxi7SIMwzAMw0hOElLZmTx5MgDNmjVj3759vhcMouykx3333QfAG2+8ARC1+Pp1110HwLJly7J8LFJKvv32WwAqVKgQ6mGm4OjRowC88847ADz11FMAHDp0KEPPP/XUUwHczvett94CoESJEiEdZ7Jx+PBhAPr16wd4asO6deuoXbs2ADNnzgRgz549J3y9+vXrM2zYMADOPPPMjAwhqZQd8M759957D4Cnn34agOHDh/Poo48CsHjxYgCKFSsWiSGl4q+//gJ8Ct/06dMBnNdIajLAhRdeCPj8RuBT9sSvv/4KQKlSpcI+3mDs3bsX8KnIv/32G+Ap37///jsAK1euBHyqWt68eQHIlSsXALfeeivgU5iLFCkSuYGnwx9//EGtWrWAlIqOkLJz1113RXRcMU6ac0xCGpR3794N4BYHwciRIwd33303ABdffDEAr776KgBHjhzhgw8+AOCkk3zi19ChQ8M23vTQJBLsWHShdujQwU1Ay5cvB7wFwu7du9m1a1eK28J9LP379wegW7duWXq+Jq6pU6cCuBDLnDlzQjC65GXAgAEAvPDCC6nu0wK4UaNGQMrFzh9//AHAwIEDUzzniy++YMKECQAu7GukRCGq559/PsXtjzzyCK1btwait8gZMWIEAF27dgVg69at7r5ChQoBuB/+HDlysHPnTsALS59yyimAb/6MVghu/PjxADzxxBOAb+GmsVSqVAmAMmXKpPjrj475s88+A6B69eq0a9cuvIPOIB988EHQRU6soM9Ov5v//PMP+/fvB+CCCy4AoG3btkBsbFQtjGUYhmEYRkKTkMpOehQvXhzw7UR79uyZ4r4lS5YAMGXKFHfbwoULIze4dChatCj3339/itskK7dp0ybV4x966CEALrroIndbpI5FikwwFCaRKiX69u0L+NSbHTt2hG9wScx33313wscofOvP5s2bAZg3b16Kv0WKFOGSSy4J3QAThFWrVgHw0ksv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mgT4ishKMc9sD7cgmLJjGIZhGEZyYsqOYRiRwpQdwzDCiSk7hmEYhmEkJ7bYMQzDMAwjobHFjmEYhmEYCY0tdgzDMAzDSGhssWMYhmEYRkJjix3DMAzDMBIaW+wYhmEYhpHQxF3Xc8MwQsuRI0d49913AdiyZUuK+zp16hSWTu2GYRiRxJQdwzAMwzASmoSsoDxy5EgA7r33XgYMGABAsWLFgJD03ogZtm/fDviOt1evXgDs2LEjxWNq1KjB5MmTAciXL19kB2jENKtWrQKgevXqbN68OehjypUrxzfffAMQCoXHKigbYWXnzp3ccccdAOi3rVGjRgA0aNAAgAsuuCA6gzOyxH///QfA0aNHAciTJ096D7cKyoZhGIZhJCcJpex8//33ADRs2BCA3bt3u/tOOeUUAHr06AHAxo0badOmDQBly5bN+kgjyKJFiwB4/fXXAfjhhx8AWLdunXuMju/aa68FoEqVKpx++ulhH9tXX32V4m8wtm/fzv79+wEoXrz4CV9z8eLFANx///2AT6mLNtu2bQNgw4YNrFy5EoBx48YBMGHCBMC3o8yRw7fBuP322wHvO4ulXeXXX38NQO3atd010Lp16xSP6d+/P4ULFwZg+vTpAO7/WcCUHSMs6Lq87777mDZtGuApO7oWzz33XMCncFepUgWARx55BICKFStGdLyGx759+zh27BgAb7zxBgB79uxx9//4448AzJw5E/C+1zT8pW3IAAAgAElEQVQwZccwDMMwjOQkoZQdeVOk7AAULFgQwCkKR44c8b3B8eOcddZZgOfxuemmm7I43PCzevVqrr76agD27t0LeCvc8847j6eeegqARx99FICTTorMOlYeIe2M/FWmjBC4+wpG06ZNARg9enQWRhgapN48+eSTAKxfv96NOfAY/JUd3Ve0aFEAZsyYQenSpSM38HTwV3bkc9BxihUrVtC/f38Azj//fACef/75rL6lKTtGSNm5cycA99xzD4BTdSD9uUX36TdAvx2aY43wcfjwYQDmz58P+H6vA72m6ZFVZSehUs81efujH98333wTgOeee87dt3XrVsBbHE2ZMgWAatWqhXOYmUInRvPmzd0iR9SrVw+AV155JWo/oB999BHgfc558+bllltuAWDixIkAlC9fHoADBw7w22+/nfA1W7VqBUDOnL7TU+HGWOCff/4BUl5w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vvnmbL3m4sWLAV/LjGuuuQYI3tYpk5iyYxiGYRhGchLb2+MQoGJM2pXI01KoUKFUj5UXZsiQIS5rSKtPxX21Ao0lTjnlFO6//37A221HqibNb7/9BkDDhg0BXyaKVv4nnZT5tXTx4sVdRpkKhW3YsAHwZbdImVMRwlhFJd8DPQAxqqSmyY4dO6I9hJhHBRhffvllwPPLffvtt07xkJIQKeQfksIbitpOqr0kP6Pmxqxc5yfiyiuvpFu3boBXV0xet+zy888/uwa/yrqNJa+OOOmkk1xLF80bUg0XL17MQw89BMBTTz0FhFcpVmPXU089NduKjpDPFDxfZjhJ+MWOyIhRV2bmrl27provllITg3Httdem+L8monCj7sFaTLZu3dr1XpL0Gkq0II110qrcXahQoewU5YsYCxYsAIL3KovFsgaxgMpa9OjRA4Dp06e79GylRnfo0AEIzwLBH3X+VgXwbt26uVIDWUXm9cBQTzjKc9SqVctVR9a1VLlyZcD3+WaluN706dMB3/yuop/qpB1LJUb80XnSunVrwNtENW/e3JUg0YbklVdeAbyqxaFEG85KlSq5Cs/XXXddll5LwoF/kcrHH388myM8MRbGMgzDMAwjoUkaZScjqNCUDKT++BchjEUC20REs/9Lp06dAChRogQANWrUyPBzH3vsMReKC1RFwOteHw60Q1JRr+x856tWrQK8DuOifPny2TZxh4M9e/YAXnruq6++CsDevXvdY+6++24A1z7CCI46m997773OYKprQmbbcCsJ7du3B7xyFS1btuS+++4D4NFHHwUyf36rzYjKKohg6l92Oeecc1zBQLX8USJJo0aNXBhbx6lwVDAUSpTi5t+nqV27dqjTq+YAACAASURBVKEdeCaZO3euK+p51VVXAenP3SrWt3nzZtd3T5+L1K6vv/6aihUrhmW8H330kfs8leAjq4isFMFYtWqVSzlXOQOpa9WqVQtlu4g0MWXHMAzDMIyEJm5Sz9WAUb6arVu3AlC4cGH+/vvvFI+VufiOO+5I9020IlZ8W2Wsjx075h4zYMAAwIspptfWIJpolT948GAgckUFlZIv05q/EiBjYXrKzvfffw94je4WL17sOm8HUqhQIWdqC0fDU3kDpGD07dvX7aQyY/g+duyYa+b3xRdfAN55s3bt2oiY8TLDokWL3A553rx5qe7Xff379wey5V+LpYsnwxPf6NGjnXdCqlZGSh+sWbMmlXqihr1SV8KN3u+ll15y5Q+kKikBQF6e9K6pJUuWOOVASoQaw44aNSqsSpXmgy5durj3E4ULFwa8YnSlSpVy/hKpavp9kJIAnodK/sxIl7LQ3NipUyfnfclsmQJ9fzJyHzhwAPB9n3r9UH0vOnfGjh3rSixkNXlBBSibN28OeJ3rQ4SlnhuGYRiGkZzEjbKjVEFlsvgXaROKHSs9L9hqXbv3cePGucaSwVao2kVoB5ArV65MHkLkWLZsmXPgn3/++YBXIDFSyBvg77DPCBlpBKoyAVOmTHEZGeFEHoEZM2a4jLIhQ4Zk+PljxoxJ9TkoJr1ixQqXURFp1G5DGW3a9S9YsCCFj8GfF1980e1+Q5BBFJfKTrt27fj3338BXMNCkTdvXnLnzg146rMyE8ePH+9Sv4W8FPK/RIoff/yRzp07A94cKFQ4NZiyo+tz7dq1bNq0KcV98m5I4Qk3+nyHDRvmis/5qzwZpXfv3lFTdPSZST0+cOCA83GphIG8o/6oXdGZZ56Z6j41FvYvICtFWop5KJHSplIAy5cvB3y/yVOmTEnzefL26JpQKYMQk+YcEzeLHfH1118DntHPf9GjSSe9mgmqmOkfqhKSRL/88ks3KUUibPXrr786U6MuAi2yRO7cuVNUdgYYPny4e6zu0w9aJKpq+qNeOjfeeGOm0t7TW+xoYfvpp58CRGShA14n5Vq1ark+QDI3ymgarE6TaNq0qZtktLCRrKwLPpTI+Pf222+78eoa0CS5f/9+Jk6cCBB0YaPjUUhDx1muXLlQpknH7WLnnXfeCXrfRRdd5K41Vc1etmxZmq9VpkyZEz4mXOgaVTd2da9X+Yhg+F+fCuXKJqDaQdFYvGvho8rtGtP48eNZt25discq/V8V2UuVKuWuk0ijumRaICrkdiJkXtb54z9f6jX8qw+XLl0aiM55FmUsjGUYhmEYRnISd8qOkMIzePBgfvjhB8AzLWeUW265BfAkvyZNmgCR36kcOHDAFQWUJBioeJx55pkuJTqYGiJjcjjSQDPD0KFDXeG0QCUqGDoW9ZBq27atM6FLstUuJVJo3DfffHMqyV+KX8eOHbnnnntS3Kc01pEjR6ZQuiAkPV/SRDK21KeMovP8zjvvdAZ89SMKE3Gp7IwdO9ZVJM7oTjwQhcGlwkWjY3UgCke8/fbbQHBrgMyv4B1DrBns/Tl48KCzPAgVe4yWmhOMjz/+GPDNGVJaA43/Bw8eTDWHZiTsnzNnTmfDCAyjJgGm7BiGYRiGkZzErbLjj3bR6hGicta///47derUAbzUaJnAChUqRO3atYHYSCdXLFdeHRnvgo0tcHXfsmVL5ynQLiaajBw5EvBSlZcuXZrqMVJFAr1K6n0VC/z++++unLx/HxfwfQeBn7W/F0bnmwx74TS4K6W2ZcuWbicof47GePfdd7u0afkFdP5EcMcb/QvNI1NzjErzy9Mkz8iJUAFJXQvZbdlgJB5SfatVq5bi9smTJzulX0hpC/a7oBIRFStWdD21khBTdgzDMAzDSE4SQtlJRNQqQaXZP/vsM5flpDLd2qE/+OCDMRWPTiRUQE3eHRXACqZWibJly7rHSVk0gDhWdoTOAymT119/far0XrU0KVeunEtVjyXF0jASmMRJPTcMI26J+8WOYRgxjYWxDMMwDMNITmyxYxiGYRhGQmOLHcMwDMMwEhpb7BiGYRiGkdDYYscwDMMwjITGFjuGYRiGYSQ0ttgxDMMwDCOhscWOYRiGYRgJjS12DMMwDMNIaGyxYxiGYRhGQmOLHcMwDMMwEhpb7BiGYRiGkdDkjPYAYolt27YBsGHDBlauXAnAuHHjAJgwYQIAx48fZ+HChQBcddVVIR/Dv//+C8CoUaNSvP/+/ftZt24dAIUKFQIgRw5fz7MqVaqkep2WLVsCULVq1ZCPMZmpW7cuAFOnTuW+++4D4Pzzz0/z8eXLlwfgjjvu+H/tnXucjWX3xr+T16GkXglFFHLuqBDqRakUiSgllUrKsckhqgmRTkRUmKQoRTooRSmHlBLKMTJUQgnx0wFRjN8f+3Pdz549e8Yc9nnW95+Z2XvPnnv2fvbzrPtaa10L8N6zcKPjpl27du7n1q1bH/X3/vjjDwA2btwIwKRJk6hSpQoA9913XziWahhGCFizZg0AV155Jdu3bwfgtNNOA2Du3LkAVKtWLTqLiwEKbLDz22+/MWPGDAA+//xzABYtWgTA5s2b3UVJU+HDfZEaP348AE8++SSAC2yCsWPHjgw/r1+/PtNjJk+eDMDo0aPp2rVriFZpHHOMTwxNSkrilVdeCfqY4sWLc+DAAQAKFSoE+I4pgLJly0ZglfD1118D3nF7yy23cOONNwJwxRVXAPDLL78AMHPmTHec79q1C4B169YBvmBJx6RRcOjduzcAb731lrvtjTfeAKBBgwZRWVNe2bJlCwCfffaZ+zphwoQMjxk2bBiQceNSr149IHYDBG26n3rqKQC++uorAA4fPsxLL70EQMOGDYHY/R8iiaWxDMMwDMNIaAqcsvPoo48C8PDDD2ep3uhngAsuuACAmjVrAr6UUXZpi7yyYMECAA4ePBj0/n79+rmUSHbMmzcPgE2bNgFQokSJEK0w98ycORPwUoD+aBeidKGoWrWqS6Fkx6mnngp4r1v16tXztda80LNnTwAqV66c4faOHTvywQcfAFC+fHkgcoqO6NKlC4Db4dWtW9ftBLU2ceONNzqVp2nTpgAUK1YMgHvvvZeiRYtGZM3xyOHDh52KVr9+/Uz3/9///R8AK1asyHTf9OnTAVzKoVSpUgCMGDGCk046KaTrXLx4MaNGjcpwmz6DF110EQBvvvlmlr9foUIFlxKJdf79918A9u7dC8ANN9wAwNKlS91jApX6lJSUTM9Tu3ZtwHudihcvHvrF+qHMwv333w/4Ppc6z4lff/0VgGnTprljSteMc845B/C9j1WrVg3rWsPNoUOHAEhPT+f5559334NXolGmTJlcPacpO4ZhGIZhJDRJ/ipGDBG2Rd16660ATJkyJUtlp0uXLq6gVPUN4ebw4cOAT3ECePzxxwGoUaMG4NsZarcdyxw8eJBPPvkEgD59+gCwYcOGsP2922+/HfAUjHDTsmVLAGbPns3ChQsBuOSSSyLyt/PClVdeCfiUHamaUSQy1dk5IyTnmF69ern6j8Dd9JEjR9i3bx+QfQ1eIHPnzuXSSy8NxfIcvXv3zqTsiAoVKgA+hUfqjb5ef/31GR4TDzzwwAMAea41O+WUUwCvuF/Pc+yxx4ZgdVlz4oknAp4i5U92taO6ZnTr1g3IveIRCQ4fPpxJxVe2pFChQk7VmjJlCgBz5swBgn9upD7Pnz8/2J/K8hxjyo5hGIZhGAlNgavZefrppwFYtmwZaWlpABx33HEAvPrqq4DXJhxJ1LWj6FcqzmOPPZbh51hn+vTpTj0LpHbt2rlq12/cuDEAu3fvBuDbb7/N9Bjlb43gXHvttYBPZVMLudQwI/eoHkS7yy+//NLdF3h8lilTxu3Eg9Vsqc5M6ttll10GeHWCoWTkyJHueyk86q5STUs8o7qV4cOHZ6lg6T24+uqrueuuu7J8ruOPPx6As846K8SrzMz+/ftp3749AH/++SfgqTfHHXecq+O69957AU9ZjrfuqtatW7taQWVLZs2aBcC2bdvo27cvAEuWLMnyOTp37gx4NU25pcAFO2o3T0tLcwdVNIMcoQv6Rx99BMBVV10V9TXlBX/pWB9MFT4WLlzYBXVGZFBR34EDB1xBrALE//ynwH3884yCHLVk+wc5alGW75I2T/o5VlDAo3ZyFd4mQrCzdu1aAAYOHJjpPpUC6P+uVatW5BZ2FGbNmsXs2bMBL8hR+r9t27aueDzeUNH9gw8+CPjS/iq2Hj16NOCdf8qVK8f5558PQPPmzQGCBqPa8CsAzC2WxjIMwzAMI6EpMFs7td2qmOvIkSOULl0aiA31ROkrmdEp0o0Xpk2bBnhmdADdu3cHsk/BqYBTEu7vv//uWtWbNGkCwNlnnw148nI00bEye/ZsZyqotIN29LGE1jt//nzee+89wDMcDLZr/PTTTwHPqEzHI3jO3f369QPiz1wuP6iFXG2w/sh5XTtWFbKuW7cuk12ECn6jqaqp8FbpHjljx1MRstJWUnSU5vHn9NNPB3xu5/4/xzqyMIhHVUcKqBSdl19+GfC17aempgKe0ubPuHHjwr42U3YMwzAMw0hoCoyyo1y77PDLlCnjIv5YZMyYMQCULFkS8BUvamcSiwrCxIkTgYyGjLJn17yltWvXOlVBqLUwsC3RHxVyjhw50s2mihaqzzjhhBPc//z9998DnuLRtGnTsLep5hSZGg4cONAd7ypaVqsq4NroFy9eDPjqqyCjkdo///wDeDvlAQMGMGDAAIACbTwoA89AVq5cmalVWDvet99+29WORLr5IFAxUE2dzpHgHQdbt251t0n5UVt6NJWgbdu2AXDhhRdmuk8WAG+//TYQP4qOWL58OeApcPHC/PnznSK8cuVKAJo1awbAQw895JT6aGHKjmEYhmEYCU3Cmwqq80RmRdppnXzyyVx33XWAV/ktk6NoKCfKdar9VMNJ/ZEd+AknnADg1h8L06hvuukmwKvdCQdt2rRx07yjzdKlS13Ng7op/vrrL8A3aV47HClBsYCUqB49egCeUlO+fHnOPPNMwNsVqwbCv3NFdVXq3vnkk09ch0+wmokgxK2p4N9//w3A66+/DnijHnbt2pVBIcvwB44cce22Un/Unn7kyBGnUj7xxBNAZFqdwVNrNPZGCk1ycjLPPPNMhsdkh+qPnn766YirPHpdW7Vqlek+1TsOHz4cwNVmqvYv1tCgZg2D1jWqWrVq7hjxtw6INXbu3An4ao0CTQBV51e4cGHX+q+62csvvxzwqcdFihQJ1XKyPMckfLBTt25dwCtQ9ndNDnRQ1ol9yJAhLpCINHJSXrZsGeDN1Fm6dKkrHg08oAoXLuwkT61bJ4EQHkTZ8vvvvwM+52e1eOrir1bBa665xj1e6Tn/2wLRh0IFy0WKFHEX3FhKm+gCKNfrtWvXOhdWFQXrOIwFkpOTAc/ZesSIEblqx9V7UKlSJefW+sUXXwAcbaZT3AY7oULHyNixY908MtkxDBkyBPBtvk4++eSwr0VBq/9MLKW4FLzovNKgQQP3uJ9//hnIOBFd738kgp758+dz8803A7Bjx46jPv6MM84APG8kf+RxFAvt95pQrrS47EjAex/Uvt2tW7eY8dr54YcfAKhTp45zfw52vtN9KioXQ4cOdRv2EMwfMwdlwzAMwzAKJgmv7KjwVW68KlAOpuz4p7hUSBuOCed5RZH+5s2bAVxKZ/jw4S4lIZQ+GTRokDMoDDZXJZZRIax/UbIMIDt27BiVNWWHjq3k5GSnRinlqPRFqKdZB6IW6XD/HfA50ko51ETpwCnNAcTSARjVE9/OnTvdPDfNLNu/fz/gs2zQbZqXFA6UipNCc9999+XKTkC/3759e6cI6bZwKDx79uwBfLOrlPbPL7IA0HpnzZoVtDU6kkhxHTdunJtyroLfjRs3Aj61XOf/iy++OAqrzMz69eudehOscFz3ydh3xIgRAKxevZqpU6cCvknv+cSUHcMwDMMwCiYJr+yILVu2AN7u2x9FmppDdeTIEWcYF4sKQjCU71de3X9OjyLoO++8E/CKxmKdeFN2/FFtxkMPPQQQ1gnpau3v3r27y/drFEA4OeWUU5yh3po1a4CjWvGbshMETXzWcf7XX385M7ZOnTpFa1k5ZuTIkW7EQTjnbUnZyeu4gJzw6KOPOnuAWEI1kSogHzp0KCVKlABg3rx5QHhmqgWydetWZ+iopoa8oqnl99xzjzOgzWGjQ3aYsmMYhmEYRsGkwJgKqvYmWA2Ocp9SuWJU7coWDcDTDkst4F27dnUTZfV/6TGxXsMTqrx8NJCZn5DSU79+/ZB3yKlNeOrUqfTv3z+kzx0MjZBIT093hm1q700EdD6YPHky4DP4DKcxnWouZI/RunVr3n//fSA+lJ3evXu7c0q0UPda69atj/rYtLS0oNYesYzU+MGDBwNwzDHHuLoudZnpfzr33HPDto7k5GRXO6osQl4/+/4dW7peycZBpqahpMAEO8FQ8bLSV/4X/1iajJsb1LqnlFXRokXd93L4lSNxdm3fsYBauhMBTbPfu3dvyIuHFcDXqlWLuXPnAp73UjiCEF2Id+/e7S5yiRTstG3bFvDOB4UKFXKFt+GcaVWpUiX3vVLr8YaKncORxtJsPKVt/FFKJ1hhbCATJ06Mu2AnkIEDBzp/LzUHzJo1C4DKlSu71yPU9OjRw23c5AmnACy3di3yrtq4caOz6gjnBtzSWIZhGIZhJDRxq+xIwjvjjDNcRJkb5+NvvvnGFQQGpq2Sk5OpU6dOiFaaGZlyKSIPp4Fhx44dXVu6FB4pWbGq7KSnpwOeeZ0oXbp0RIrw4g21t/fs2dO5sWo6t3ZdocTfFKxKlSohf/5oo3lfKgZ99913namb2sVDqc7p/BNMsYg3wjmpW6mNYOaAOUEGnx9//HGm+5QG08TxeEDqn1LmMmH97bffnLt7qDnvvPOckaiOVzXDNG7cONvicV2HXnjhBcDLNJx00kluvTLYDAem7BiGYRiGkdDEnbKjOpsnn3wSgH379pGWlgb42vFy+vu9e/d2bejKE+prmzZtQrvoAFRXo/qKDz/80O0iQ2CXnYn//e9/GX6WeVkskp6e7troA6fSt2vXzs0vi3VkAiZuvfVWILwmcV26dHEzdPQaaupwKIzHtIPTc5coUcLNIUokVJNQu3ZtwGfMOXPmTABnOKfdaYsWLfJcTKnzj+wU/It8mzdvnqfnjAb+c7Q0ET1SyPpAo2kqV66c6TGyEVFbs6wawFN09B6oDiVSbNiwwdXa5HbGoQw8NdvxxRdfBHBGhOGgZMmS3HPPPQCsW7cO8H0+wDfbS8repZdeCni1r8uWLXN1ixp7JCZNmhQRxd6UHcMwDMMwEpq4U3YUievr3r17GTZsGOBNUfVXMhT5q61TE4Z37tzplBzV+ii6D4fxmz8agil1KiUlxe1ItLOQutSiRYsMa8wLGjgoYtmQLyUlxe2shbowevbsGZa/KVM3GblpOnhuUcfOsGHDnIKonY3qpMKZkwYvj68RIR06dAB8XSqpqalA7junZFQo1Uifm5SUlISs2RH6nJQvX55evXoBXr2S6uzOP/98V/un91q1cDpu/dExMmvWLBYvXgx4r69o2rSpOzfEA/6KVG7GTeQHjUVp37494Ck7GqAMnoVA586dATh06FCm51FrvwaCRppVq1a5169q1aoAtGzZMke/u23bNsBTGfW5DFTyQ41UYik1UnY2bdrkzj856SbU8R8ptT5uHZTXr18P+E4wepPVgitZLz093V24NE8q2NRztUuGO32VHZL2lO6QNCzPhOTkZNcynpMTig627777zhWpyrdm9OjRAO4EnheUClOhuAKFZs2auaAxO3bu3Al4H1QV1O7cudMVKAsVFmqSe6iRfDxmzBjA81dp0aKF+z4YmzZtArxAWifcQ4cOuRkvEyZMAMKTnswOBVu6EG/evNm15ep4UGAdbIL8vn37AN9xpMJHtYrKkbtDhw4cc0yuxOFYMnbK1YlPmyallyThy03WHxVp1qlTh1WrVmW4T8e9P0ptyiure/fuIfdiyg6da/r06eOCsZygi1XDhg1d+kK3hRt99hRs6xju27evuw7IX0yfS390wdYMu0jMkgvGm2++6c4VKvxVkFaqVCk32Tzwdd2wYQM9evQAvM+qrg+LFi0Kq8t0VqSnp7vzndbkzxVXXAF465SNQ4jbzc1B2TAMwzCMgkncKjuicePGziAqcHp5sMnmip579uxJSkpK6FYcIiRpa5enabDgRcI5KYiUy63/+6s00FNPPQVAsWLF8rxOzXpq0qRJhtt/+uknypUrl+E27Ureeecd127/008/AcGL6bSuBx54APBagcO129VuVjss7RILFSqUq2JuSeIDBw50Jln5eY1DwQ8//AD4VKsFCxYAXipGCmH58uUzfXakXKxbt861tqrAMx9uuXGr7ASi13XEiBF8+eWXgGeVIBXZ//wj9BmuWbOm2+FKPTz22GPzs6R8U7FiRafQSO0MpiLr86wU0tatW8M6EysYeq1vueUWwDO6zAmNGjVyjr2BTueRZvHixU7xkBqiY6ZUqVJu/pRm3QVTQXTcSFGPZoYiBjBlxzAMwzCMgkncKztbtmxxeULtRpWH9d9ZaZKt6nmCzciKJVQLoBbmJUuWuFyuVJWc0Lx5cxfpS7mQCV1+UC2Uiv9CRevWrV0LZaTyzvoMqL14+fLlgK9WaPXq1YC3Y9VuvGLFiq6+SoQpBx0ytBtWnZVqob7//vtMys4dd9wB+JQpGRWGYIRKLL0wIT/xqZVcx8yKFSsyteZLnQyFFUComT59uqtzUR1PhQoVgIxmgVIZxIgRIyKm6AQihWbcuHEA2Y6B0P8wd+7cfDV8hBqp26qFW7FihbtP5yJ9dv3PLWrX1udYregFHFN2DMMwDMMomMS9smNEhyVLlgBet49aQY+Gallk+a56HHVDnHrqqWFvzzaiRkIrO4mAFB1NtNZXfzVHColq3aT+RBOdf2677TZn0icmTZoEeOecWFivETZM2TEMwzAMo2Biyo6RL1QnpXzz5MmTOfvsswHcMFXtBGvUqOEs+KPhA2FEHVN2DMMIJ1meYyzYMQwjUliwYxhGOLE0lmEYhmEYBRMLdgzDMAzDSGgs2DEMwzAMI6GxYMcwDMMwjITGgh3DMAzDMBIaC3YMwzAMw0hoLNgxDMMwDCOhsWDHMAzDMIyE5j/RXoBRMNEMnrPOOguAVq1aATB+/HiKFy8etXUZhmEYiYcpO4ZhGIZhJDQFRtnZvn07AHv37gVg0aJF2T7+9ttvB6BMmTIAPPnkkwC0a9eO448/PlzL5JtvvgFgwoQJme5LTU0FICnJ54itUR9JSUnu+5SUFACGDh0atjWGgjlz5gBQqVIlAF599dVoLidf6D2bPHky4DvGdu7cCcDixYsBOO6449zPp512WhRWmTuWLVsGQL169ejevTsAzz33XDSXFDd8+umnADzyyCPu+0GDBgEwePDg6Cwqj2zevBmAUaNG8fXXXwMwbdo0gLg4jg1DmLJjGIZhGEZCk5DKjtSbfv36kZaWBsDvv/8OwD///AP4pnUXKlQoy+c44YQTAE95qFy5MgD/+U94X7Krr74agF27dgEZ1RspOvoqkpKSuPvuuwFPEYp1ZUc1O6effnqUV5I3Pv/8czfpfenSpQDs2LEjy8fv2bMH8E2CX7FiBQDly5cP8yo9Vq9ezUcffZThtosvvhjwqZwvvvgiAFu2bAEyHnfz5s2L2DrjGak2jzzySKb7Am+LF4Vn2LBhAKxZs4ann34agFNPPTWaS8o3hw4d4rfffsvx48uWLQvAMcfEpjag/+WPP/7IdJ/Or4ULF47ommKRhJx6PmnSJADuuuuuLB9z+PDhTMFOr169ADjxxBM599xzAbj22mvzs5Rcc9111wHw7rvvAhkvOldeeSUAbdq0yfA7NWvW5JJLLongKvOPXt927doB8PDDD+fo9xSsFilSJDwLywK9Dy+99BIAPXr04ODBg0Efm93aKlasyBdffAFA6dKlQ7zKrKlUqZJLSYiiRYsCZPl/iE6dOgHe/54PEnLqedOmTQEvfZWjPx6b513Ht99+C8D5558PQPv27d1GrFy5chnuA+//0WYwnKn+3PLDDz8A3oX/sccey1WwecsttwBemjoW2L59O6+99hoAY8eOBeDHH3/M9LjmzZsDcOaZZwLw7LPPRmiFUcOmnhuGYRiGUTBJyDRWTlGBnXZkSiuEO1WVHVOmTAG83cSMGTMAn7IjpUrqTzyidOLu3bsBrxB23Lhx7jFSfapWrZrhd1etWuUKyyOdBtC6g6mFFSpUAKBBgwaA7z2M5jEUjH///TfTbVJ0Klas6FSmunXrAt7uvWvXrjG1S481Bg8enKWis2DBApo0aQJkTj3HOkp5ygZizZo1vPPOOwAcOHAg0+Ol7LRo0QKADz74IBLLzJZVq1YB3jEtleNoa6tduzbgpYXUPBENZUfpb1GyZEnAp07lRKXR+6iGm4KMKTuGYRiGYSQ0sbX9DAMyq1OdhBQFgC5dugCxVSSrFuW3334b8Frfd+3a5YqW4xnVjfzyyy+A9368//77Ofr9AQMGhGdhR0F5f3+0W3r88ccB772KddQGreO/aNGiroCxRIkSUVtXorBgwQIAp+r4f9+4ceMorCjn/Pnnn4BXQ3f55ZcDMHPmTH799VfAUwllq7Bnzx4qVqwIeEXv0UQWCb179wZwtZkqMC5WrBjXXHMNEFzx+N///gd4hb/fffddeBecBX/88QcdOnQAoFmzZgD06dMH8Gqq/GnUqBEAffv2dY01QmpVLLB//37Aa4bYsmWLO+5kMivrji1btnDhhRdm+H1dr4899thc/V1TdgzDMAzDSGgSshtL7N27l1tvOmRU4wAADrpJREFUvRXwupvECy+8QOfOnUPxZ8LKPffcA/hayq+44goAPvzww2guKV889thjADz00EOAl1OWorB69Wo2bNgQ9HdbtWrlus6ysw0IJYcOHQK8rrGZM2e6+/R+1KhRA/DUOPAsBFRbFO123dNOO41t27YBsH79egCqVasW6WXEUuFKSM4x/rU4wRSdeEMK6/XXXw/AV199BcB5550XtTXlhjFjxnD//fcDXuemagCl9NSqVYsLLrggOgvMBT179nQq1ZgxY9xtAAsXLnR2KKJUqVKAlx2INUaOHAl4tU9r1qzJ8rH+XciBnHPOOQCsXLky2K9meY5J6DRWv3793Ic38OLYrFkzfv75ZyA+nECPHDmSEGksSZhnn3024EnGkiQbNmwYnYVlgQIY/yBHfPzxxxm++iO/o88++wzw0qly4o4mksCjEOwkHE2aNMlVy3mso+C8devWQPwEOfoM9u/f3wU5Qhsq+eXEKocPHwa8VP348ePdxV4XeNGgQYOI22/kh/79+/PUU08BnoedfJtOPPHETI/PLtjJ63nL0liGYRiGYSQ0Ca3syD05GJUrV3ZtfDITFNdee23M7WjirXU1GHv27HHGdGrhzm2RWaTxT03lBR2DkqFr1arFbbfdlu915Zbq1au7NNb06dOB4BYGau33L+QXkv7jQQmNFI0bN84wCwviN4318ccfuxSy3MFjHanz/fv3BzIaZKoEINYVnX379gEwZMgQIONrLyPZwML2WFd10tPTAS/V9Nprr7nrrVy5u3btGtE1mbJjGIZhGEZCk9AFyt26dQs6PRyCj4sQpUqVcpN9pfD897//DcWSco0matetW5eTTz4ZwE0fDjbfRY+JpXZ6kZqammm3JfNEGfN16NDB/Q/RZt26da7tUUZqMgu84IILXIGyio/btm0L+ArjH330UQBeeeUVwMvHFylShHXr1gFkKjAMJxMnTnRqmnZYMoArW7asa62fP38+4LUg+6O2YtUh5YFYkidDduILVF3jrVBZ6kjdunWdYhA4WiRWUbOGjmV/ZIapOrlIKwk55fXXXwegY8eOQMZRImqwkXKl+pZIztXLC5pPqdrMzZs3O9U4zHWZNi7CMAzDMIyCSUIrO3v37nUW54F06tQp2/Zl7cSjPQROyk69evVcxF+rVi0ApxAkJSW5+2RspyF9Dz74YNSHhKo7okmTJs6ITMqOLNmlnDRr1oyJEycCOKOyaCK1Rrnn559/HvCs54+G2l2feeYZd9vChQsBIvq+7Nixwx0T27dvz9NzaHCouirUBpsLElLZCRwEKkVn0KBBcaHu9OjRA/ANlFSreb169TI8ZvPmza5VWMdRLKgLsobQ53PIkCGZxkHo3Ch7i5IlSzJw4EAA7rzzzkgt9ajIyFHH0b59+1ixYkWGx0gB79y5MykpKUBsTmOXIqXxR+CpUjIzVdbkpptuCuWfzvIck9DBTm5RYPPaa6+5D4icKINNlI0E/mmswHY8+SnUrFnTyYYqiPV/rD48avOONLo4Dhw40E3o1TR5rVsuxJMmTeLmm28GcEFPNFGh7t9//w3kvjhXTqCXXXYZAGvXrnVBwujRo0O1zBwxfvx4wJPNdSJVgSR4baH+ra7633Us6iK3devW3C4hIYMdEayJIEbPr4CXjlTxa40aNVw6M9gstUAU8KempsbExiQrtNlSse8XX3zh/r9+/foB3vknUv5dOWH//v0sX74c8D6zcp6fM2cOF110EeB5lsntOhbQ67p69WrAF+i89dZbgPeZ0OZp7Nix3HHHHaH605bGMgzDMAyjYGLKjh+abN2hQwdnRCVlJ9hspEigQsH69eu7iPjBBx8EvJ1KjRo1nFmfdihqmU5LS4ua8/LcuXMB3ByaO++80zmCZkXr1q2ZM2cO4E0nlioSz/ins7SjkWISLVQw6K/sqBC/fv367rZ58+YB3s7RlJ3gyJBPLeiQMaXl/3M00fvtr3SAT5mS+nvDDTcAwVOts2bNArzC39KlS2fpep4f1L4sM9VQzZ6bOnWqU4/F7NmzgZynp6PN66+/7gqa1TShko2WLVtGbV054fPPPwe8Y2z79u3uPZYLdD4wZccwDMMwjIJJQpsK5hbtau+++26n7EQbtZCPHTuWmjVrAriv/qh+Z+jQoYDXlr5+/fqojZkoXrw44O0OpW5kR0pKinvtVYCdCMqOP/7GZ9EkpxOqX3jhhQw/n3LKKeFYTtwjZUc88sgjrl5OX2OhLX3p0qWAr34McDMCu3bt6oqPszMxVTuxZsIFM6cMBWqJV0OGzgv5naweOEUbfHWaEB5lZ+jQoU45UoNGfunQoQOdOnUCvPoq2UbEurKj64Gut9WrV3e1guHElB3DMAzDMBKauFV2FPWPHDnSTdIuVqxYSJ5btQyxRF53T9EcM9GgQQMg+KDMrLjwwgtdjZE6EGREWLhw4RCvMHJo0ni8sXnz5ky70W7dukVpNfGBFJ4mTZq4tnShn6NZK6k17NmzJ1/PI7UiXKj2Sa3V+R0to2uGf5enjAdzojrnldmzZ7uuTNVW5ncy+aJFi5w9ilAbfjh59tlnXdZA54HcKr3fffcdgBtfk5aW5kxMQ1CzkyVxG+zojX322Wedf4J/YWB+CDYXKF7QgSgvlxgtQM+WM888E8BNrFfheOnSpfP93Jr4Ldk6KSkp08VbjsihaENVe7l/WlRtmbGMrBbuvfded5FQgWi0LAzijSZNmri0VbCgR/fFG0qbBHpmhRrN0dOGrW/fvoBvWnadOnVy/DwKCu677z7A17yhICc1NRXwvIPCwdq1a/nrr78AzzVd/0unTp1y5RivAGHo0KGugFuO6Hnwvco1n3zyiWscURpUPjkXX3xxloHPwYMHXXOK3OXVoDFjxgz3P4QTS2MZhmEYhpHQxG3r+U8//QT4ImUVys2cORPwlIGjIUM7mR2pffKJJ55wioicIKPloJxbrrrqKgDXvp2UlOSKltWyHg7ee+89ABo1apSv2VY//vijm66t6eAjR44EQuMUql1iduk9FSkWK1bMpQ/VJpnTacNqy5UVgL9MKzO/SE4P3759u3tf1KoaDBWza92jRo1y6UPN59F05jyQcK3nn376aY6KjYO1pasdPbCwOdbRjCmZVC5btixo0W9+UcGtXI5lw3H88cc79121X8tZOBg6XpcsWQL4GidUdB9i996gfPXVV9x+++1A5nT26aef7mZFSXnKLl3fpk0bwHf9U9nGG2+8AUCrVq1Cu/Ag/Pnnn0ydOhXwXSfBe1/Kli1LlSpVgMzn1/3797vznq6tKjRXK3qIsNZzwzAMwzAKJnGr7KiO4Nxzz3W75urVqwNe9Os/90S7aNV/7N2710X8r776aqbn79ChA+DVXIR76rkModRurbkn2SFzsBkzZjBs2DAg87iI6667zhkMhpMXX3wR8M1CUau43oezzjrrqL+vHU/nzp3dayA1TaaEoUDF5yp+XrlypZsHlB06tsqVKwfA9ddfn+VjU1NT2bRpE5B5enifPn0YPnx47heeR1S71bJlS6ckqGVVbNy40X0GVCclW3qA+++/H/B2cvkg4ZSdpk2burbyQOPAYIqPv8ITaWVHdY76rEptkMlldhw4cMDNbtKcN6kqqampOVY884LOaX369AFyXxitc6EKnLt06ZJhVl0kUGGyVIxp06YBvqyCMgy5oWLFis4CIHAWWKSRIvX1119n29yjeh7VLIapKNyUHcMwDMMwCiZxq+yIhQsXuroK7aJVfe/fTaNKde3CVq5cmW23TU4G4YWSunXrAp7CoTokUbNmTapVqwZ49TFSdtLS0jINCZVx0yuvvBLRIX3vv/++yx2rNkTdci1atMj0eE091yiLQ4cOOdUlEvn09PT0TC2c6tAYOXIkv/76K5B3I0CZZWnI7OjRoyM6pXjcuHEAdO/ePU+/X6lSJddJVrVq1fwuJ+GUncGDB2fbBSp1R+cdfyKt7Oizps6XL7/8EsANlARPBZFyLiXiueeeyzBZHCA5ORnIvgYslGig59KlS3n55Zdz/HtSnVRzdsYZZ4R8bXnl22+/dV1Jo0aNAnwKCfgUV6EO0UaNGgG+c2mgQhsLSIULhqaeh9mUNLGnnmt2j/x21NKZXTBz+PDhTPerGHngwIHOuThSKI2lCbbBppcHBjT+P2vOjdIR+SkSzg9HjhxxH9Lp06cDXgH4qlWr3OM0Z0kfAJ2Ak5OTnUN0ND2ChFJpU6ZMAbxjLTuaNWvmjp9evXoBnutspFEhpryKjoYuDJp/NWfOnBwX/OeA6L+hHiE78QUrPs4JkQ52Dhw4AHgOwkrNy3H3s88+c2n+wNRuy5YtXdF9MAd3I3SoSUDBKXi+PAp6jCyxNJZhGIZhGAWThFB2AtFufPfu3U66DKRhw4YZCpjBcymW4VQ0UCGblB5NJAYvvdK2bVvAS3W1adMmVyZbRu5RqktmewATJkwA4KSTTgK896VKlSoRTVXlhNGjRzvlQbt30axZM2d2NmDAACBsUn9CKjuBKGUVaCToz6BBg6LWcr58+XIAN/lbqfOkpCRnuyDVp127dkD45l8ZRogxZccwDMMwjIJJQio7hmHEJAVC2TEMI2qYsmMYhmEYRsHEgh3DMAzDMBIaC3YMwzAMw0hoLNgxDMMwDCOhsWDHMAzDMIyExoIdwzAMwzASmsgMNck9sdSiahhG4mHnGMMoQJiyYxiGYRhGQmPBjmEYhmEYCY0FO4ZhGIZhJDQW7BiGYRiGkdBYsGMYhmEYRkJjwY5hGIZhGAmNBTuGYRiGYSQ0FuwYhmEYhpHQWLBjGIZhGEZCY8GOYRiGYRgJjQU7hmEYhmEkNBbsGIZhGIaR0FiwYxiGYRhGQmPBjmEYhmEYCY0FO4ZhGIZhJDQW7BiGYRiGkdBYsGMYhmEYRkJjwY5hGIZhGAmNBTuGYRiGYSQ0FuwYhmEYhpHQWLBjGIZhGEZCY8GOYRiGYRgJjQU7hmEYhmEkNBbsGIZhGIaR0FiwYxiGYRhGQmPBjmEYhmEYCc3/A/uBhrNsdxf+AAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<Figure size 576x576 with 4 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "cl_a, cl_b = 3, 5\n",
    "X_aa = X_train[(y_train == cl_a) & (y_train_pred == cl_a)]\n",
    "X_ab = X_train[(y_train == cl_a) & (y_train_pred == cl_b)]\n",
    "X_ba = X_train[(y_train == cl_b) & (y_train_pred == cl_a)]\n",
    "X_bb = X_train[(y_train == cl_b) & (y_train_pred == cl_b)]\n",
    "\n",
    "plt.figure(figsize=(8,8))\n",
    "plt.subplot(221); plot_digits(X_aa[:25], images_per_row=5)\n",
    "plt.subplot(222); plot_digits(X_ab[:25], images_per_row=5)\n",
    "plt.subplot(223); plot_digits(X_ba[:25], images_per_row=5)\n",
    "plt.subplot(224); plot_digits(X_bb[:25], images_per_row=5)\n",
    "save_fig(\"error_analysis_digits_plot\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Multilabel classification"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 70,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "KNeighborsClassifier(algorithm='auto', leaf_size=30, metric='minkowski',\n",
       "           metric_params=None, n_jobs=None, n_neighbors=5, p=2,\n",
       "           weights='uniform')"
      ]
     },
     "execution_count": 70,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.neighbors import KNeighborsClassifier\n",
    "\n",
    "y_train_large = (y_train >= 7)\n",
    "y_train_odd = (y_train % 2 == 1)\n",
    "y_multilabel = np.c_[y_train_large, y_train_odd]\n",
    "\n",
    "knn_clf = KNeighborsClassifier()\n",
    "knn_clf.fit(X_train, y_multilabel)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 71,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[False,  True]])"
      ]
     },
     "execution_count": 71,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "knn_clf.predict([some_digit])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Warning**: the following cell may take a very long time (possibly hours depending on your hardware)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 72,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.976410265560605"
      ]
     },
     "execution_count": 72,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_train_knn_pred = cross_val_predict(knn_clf, X_train, y_multilabel, cv=3)\n",
    "f1_score(y_multilabel, y_train_knn_pred, average=\"macro\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Multioutput classification"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 73,
   "metadata": {},
   "outputs": [],
   "source": [
    "noise = np.random.randint(0, 100, (len(X_train), 784))\n",
    "X_train_mod = X_train + noise\n",
    "noise = np.random.randint(0, 100, (len(X_test), 784))\n",
    "X_test_mod = X_test + noise\n",
    "y_train_mod = X_train\n",
    "y_test_mod = X_test"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 74,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure noisy_digit_example_plot\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 2 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "some_index = 0\n",
    "plt.subplot(121); plot_digit(X_test_mod[some_index])\n",
    "plt.subplot(122); plot_digit(y_test_mod[some_index])\n",
    "save_fig(\"noisy_digit_example_plot\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 75,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Saving figure cleaned_digit_example_plot\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": [
    "knn_clf.fit(X_train_mod, y_train_mod)\n",
    "clean_digit = knn_clf.predict([X_test_mod[some_index]])\n",
    "plot_digit(clean_digit)\n",
    "save_fig(\"cleaned_digit_example_plot\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Extra material"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Dummy (ie. random) classifier"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 76,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.dummy import DummyClassifier\n",
    "dmy_clf = DummyClassifier()\n",
    "y_probas_dmy = cross_val_predict(dmy_clf, X_train, y_train_5, cv=3, method=\"predict_proba\")\n",
    "y_scores_dmy = y_probas_dmy[:, 1]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 77,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "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": [
    "fprr, tprr, thresholdsr = roc_curve(y_train_5, y_scores_dmy)\n",
    "plot_roc_curve(fprr, tprr)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## KNN classifier"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 78,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "KNeighborsClassifier(algorithm='auto', leaf_size=30, metric='minkowski',\n",
       "           metric_params=None, n_jobs=None, n_neighbors=4, p=2,\n",
       "           weights='distance')"
      ]
     },
     "execution_count": 78,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.neighbors import KNeighborsClassifier\n",
    "knn_clf = KNeighborsClassifier(weights='distance', n_neighbors=4)\n",
    "knn_clf.fit(X_train, y_train)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 79,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_knn_pred = knn_clf.predict(X_test)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 80,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9714"
      ]
     },
     "execution_count": 80,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.metrics import accuracy_score\n",
    "accuracy_score(y_test, y_knn_pred)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 81,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAP0AAAD8CAYAAAC8aaJZAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4yLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvOIA7rQAABu5JREFUeJzt3UuIzf8fx/Ez7kyu2SBZsBK5RLNQwoKV206JqJGFy8akZGNh9bNjlJiFLCjJLGYlioWUJBJlkkIWbMQCRZr/9r9w3uM3xpzxez0ey3n1nfNNPfssPs3RNjAw0AByjGn1CwAjS/QQRvQQRvQQRvQQRvQQZlwrPrSnp8c9IfxhnZ2dbT/7uZMewogewogewogewogewogewogewrTknn406+zsbPUrwB/lpIcwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocwoocw41r9AvDjx49y//Tp0x/77O7u7nL/8uVLuff395f72bNny72rq6vpduXKlfLZSZMmlfvXr19/+nMnPYQRPYQRPYQRPYQRPYQRPYRxZUej0Wg03rx5U+7fvn0r93v37pX73bt3m24fP34sn7127Vq5t9L8+fPL/dChQ+Xe29vbdJs6dWr57LJly8q9GSc9hBE9hBE9hBE9hBE9hBE9hBE9hHFPH+LRo0flvmHDhnL/k3/eOpqNHTu23E+ePFnu7e3t5b5z586m29y5c8tnZ86cWe7NOOkhjOghjOghjOghjOghjOghjOghjHv6EAsWLCj32bNnl/tovqfv6Ogo9+o++/bt2+WzEyZMKPddu3aV+2jkpIcwoocwoocwoocwoocwoocwoocw7ulDzJo1q9xPnTpV7n19feW+YsWKcj98+HC5V5YvX17ut27dKvfqb9qfPn1aPnv69Oly/xs56SGM6CGM6CGM6CGM6CGM6CGM6CGMe3oajUajsW3btnIf7HvxB/u/1J88edJ06+npKZ/t6uoq98G+W76yZMmScj9//vyQf/do5aSHMKKHMKKHMKKHMKKHMKKHMK7s+CXTpk37reenT58+5GcHu9LbsWNHuY8Z42z7f/41IIzoIYzoIYzoIYzoIYzoIYzoIYx7ekbEiRMnmm4PHz4sn71z5065D/YV2Bs3biz3NE56CCN6CCN6CCN6CCN6CCN6CCN6COOenhFRfU31hQsXymdXrlxZ7vv27Sv39evXN91WrVpVPnvgwIFyb2trK/fRyEkPYUQPYUQPYUQPYUQPYUQPYUQPYdzT03ILFy4s94sXL5b73r17y/3SpUtD2hqNRuPz58/lvnv37nKfM2dOubeCkx7CiB7CiB7CiB7CiB7CiB7CiB7CuKdn1Nu+fXu5L1q0qNyPHDnSdBvsO/OPHTtW7q9fvy7348ePl/u8efPK/U9w0kMY0UMY0UMY0UMY0UMY0UMYV3b89ZYuXVruV69ebbr19fWVz+7Zs6fcz507V+4vXrwo95s3b5b7n+CkhzCihzCihzCihzCihzCihzCihzBtAwMDI/6hPT09I/+hv6izs7PVr8AoMnHixHL//v17uY8fP77cb9y40XRbt25d+ewv+On/o+2khzCihzCihzCihzCihzCihzCihzD+np6/3pMnT8r92rVrTbcHDx6Uzw52Dz+YxYsXl/vatWt/6/cPhZMewogewogewogewogewogewogewrinp+X6+/vL/cyZM+V+/fr1cn/37t2/fqdfNW5cndCcOXPKfcyYkT93nfQQRvQQRvQQRvQQRvQQRvQQxpUdw2Kwa7HLly833bq7u8tnX716NZRXGharV68u9+PHj5f7li1bhvN1hoWTHsKIHsKIHsKIHsKIHsKIHsKIHsK4p6fRaDQa79+/L/dnz56V+8GDB8v9+fPn//qdhktHR0fT7ejRo+WzW7duLfdW/Gns7/r73hj4LaKHMKKHMKKHMKKHMKKHMKKHMO7p/0M+fPjQdNu/f3/57OPHj8v95cuXQ3qn4bBmzZpyP3LkSLlv2rSp6TZ58uQhvdPfzEkPYUQPYUQPYUQPYUQPYUQPYUQPYdzTjyL3798v93/++afcHzx40HR7+/btkN5puEyZMqXpdvjw4fLZwb5bvr29fUjvlMpJD2FED2FED2FED2FED2FED2FED2Hc048ivb29v7X/jsWLF5f75s2by33s2LHl3tXV1XSbMWNG+SzDy0kPYUQPYUQPYUQPYUQPYUQPYdoGBgZG/EN7enpG/kN/UWdnZ6tfAYZL289+6KSHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMKKHMC35e3qgdZz0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EEb0EOZ//SLyMUPkY7wAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "from scipy.ndimage.interpolation import shift\n",
    "def shift_digit(digit_array, dx, dy, new=0):\n",
    "    return shift(digit_array.reshape(28, 28), [dy, dx], cval=new).reshape(784)\n",
    "\n",
    "plot_digit(shift_digit(some_digit, 5, 1, new=100))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 82,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "((300000, 784), (300000,))"
      ]
     },
     "execution_count": 82,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X_train_expanded = [X_train]\n",
    "y_train_expanded = [y_train]\n",
    "for dx, dy in ((1, 0), (-1, 0), (0, 1), (0, -1)):\n",
    "    shifted_images = np.apply_along_axis(shift_digit, axis=1, arr=X_train, dx=dx, dy=dy)\n",
    "    X_train_expanded.append(shifted_images)\n",
    "    y_train_expanded.append(y_train)\n",
    "\n",
    "X_train_expanded = np.concatenate(X_train_expanded)\n",
    "y_train_expanded = np.concatenate(y_train_expanded)\n",
    "X_train_expanded.shape, y_train_expanded.shape"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 83,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "KNeighborsClassifier(algorithm='auto', leaf_size=30, metric='minkowski',\n",
       "           metric_params=None, n_jobs=None, n_neighbors=4, p=2,\n",
       "           weights='distance')"
      ]
     },
     "execution_count": 83,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "knn_clf.fit(X_train_expanded, y_train_expanded)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 84,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_knn_expanded_pred = knn_clf.predict(X_test)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 85,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9763"
      ]
     },
     "execution_count": 85,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "accuracy_score(y_test, y_knn_expanded_pred)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 86,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[0.24579675, 0.        , 0.        , 0.        , 0.        ,\n",
       "        0.        , 0.        , 0.        , 0.        , 0.75420325]])"
      ]
     },
     "execution_count": 86,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ambiguous_digit = X_test[2589]\n",
    "knn_clf.predict_proba([ambiguous_digit])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 87,
   "metadata": {},
   "outputs": [
    {
     "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": [
    "plot_digit(ambiguous_digit)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "# Exercise solutions"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 1. An MNIST Classifier With Over 97% Accuracy"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Warning**: the next cell may take hours to run, depending on your hardware."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 88,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Fitting 5 folds for each of 6 candidates, totalling 30 fits\n",
      "[CV] n_neighbors=3, weights=uniform ..................................\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "[Parallel(n_jobs=1)]: Using backend SequentialBackend with 1 concurrent workers.\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[CV]  n_neighbors=3, weights=uniform, score=0.9717617659308622, total=10.9min\n",
      "[CV] n_neighbors=3, weights=uniform ..................................\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "[Parallel(n_jobs=1)]: Done   1 out of   1 | elapsed: 52.2min remaining:    0.0s\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[CV]  n_neighbors=3, weights=uniform, score=0.9706715547408765, total=10.7min\n",
      "[CV] n_neighbors=3, weights=uniform ..................................\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "[Parallel(n_jobs=1)]: Done   2 out of   2 | elapsed: 103.2min remaining:    0.0s\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[CV]  n_neighbors=3, weights=uniform, score=0.9689166666666666, total=10.1min\n",
      "[CV] n_neighbors=3, weights=uniform ..................................\n",
      "[CV]  n_neighbors=3, weights=uniform, score=0.968575477202634, total=11.0min\n",
      "[CV] n_neighbors=3, weights=uniform ..................................\n",
      "[CV]  n_neighbors=3, weights=uniform, score=0.9704068022674225, total=11.0min\n",
      "[CV] n_neighbors=3, weights=distance .................................\n",
      "[CV]  n_neighbors=3, weights=distance, score=0.9723448563098709, total=10.9min\n",
      "[CV] n_neighbors=3, weights=distance .................................\n",
      "[CV]  n_neighbors=3, weights=distance, score=0.9716713881019831, total=11.2min\n",
      "[CV] n_neighbors=3, weights=distance .................................\n",
      "[CV]  n_neighbors=3, weights=distance, score=0.9700833333333333, total= 9.9min\n",
      "[CV] n_neighbors=3, weights=distance .................................\n",
      "[CV]  n_neighbors=3, weights=distance, score=0.9700758522964075, total=10.0min\n",
      "[CV] n_neighbors=3, weights=distance .................................\n",
      "[CV]  n_neighbors=3, weights=distance, score=0.971407135711904, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=uniform ..................................\n",
      "[CV]  n_neighbors=4, weights=uniform, score=0.9690129112869638, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=uniform ..................................\n",
      "[CV]  n_neighbors=4, weights=uniform, score=0.9682552907848692, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=uniform ..................................\n",
      "[CV]  n_neighbors=4, weights=uniform, score=0.9675833333333334, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=uniform ..................................\n",
      "[CV]  n_neighbors=4, weights=uniform, score=0.9673251646244895, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=uniform ..................................\n",
      "[CV]  n_neighbors=4, weights=uniform, score=0.970323441147049, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=distance .................................\n",
      "[CV]  n_neighbors=4, weights=distance, score=0.9730112453144523, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=distance .................................\n",
      "[CV]  n_neighbors=4, weights=distance, score=0.9722546242292951, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=distance .................................\n",
      "[CV]  n_neighbors=4, weights=distance, score=0.9699166666666666, total= 9.9min\n",
      "[CV] n_neighbors=4, weights=distance .................................\n",
      "[CV]  n_neighbors=4, weights=distance, score=0.9709093940151705, total=10.5min\n",
      "[CV] n_neighbors=4, weights=distance .................................\n",
      "[CV]  n_neighbors=4, weights=distance, score=0.9719906635545181, total=10.7min\n",
      "[CV] n_neighbors=5, weights=uniform ..................................\n",
      "[CV]  n_neighbors=5, weights=uniform, score=0.9697625989171179, total=10.9min\n",
      "[CV] n_neighbors=5, weights=uniform ..................................\n",
      "[CV]  n_neighbors=5, weights=uniform, score=0.9701716380603232, total=10.5min\n",
      "[CV] n_neighbors=5, weights=uniform ..................................\n",
      "[CV]  n_neighbors=5, weights=uniform, score=0.9694166666666667, total=10.5min\n",
      "[CV] n_neighbors=5, weights=uniform ..................................\n",
      "[CV]  n_neighbors=5, weights=uniform, score=0.9681587063432525, total=10.7min\n",
      "[CV] n_neighbors=5, weights=uniform ..................................\n",
      "[CV]  n_neighbors=5, weights=uniform, score=0.9689896632210737, total=10.6min\n",
      "[CV] n_neighbors=5, weights=distance .................................\n",
      "[CV]  n_neighbors=5, weights=distance, score=0.9703456892961266, total=10.6min\n",
      "[CV] n_neighbors=5, weights=distance .................................\n",
      "[CV]  n_neighbors=5, weights=distance, score=0.9713381103149475, total=11.1min\n",
      "[CV] n_neighbors=5, weights=distance .................................\n",
      "[CV]  n_neighbors=5, weights=distance, score=0.9704166666666667, total=10.4min\n",
      "[CV] n_neighbors=5, weights=distance .................................\n",
      "[CV]  n_neighbors=5, weights=distance, score=0.969409018921397, total=10.6min\n",
      "[CV] n_neighbors=5, weights=distance .................................\n",
      "[CV]  n_neighbors=5, weights=distance, score=0.9706568856285428, total=12.7min\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "[Parallel(n_jobs=1)]: Done  30 out of  30 | elapsed: 1523.6min finished\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "GridSearchCV(cv=5, error_score='raise-deprecating',\n",
       "       estimator=KNeighborsClassifier(algorithm='auto', leaf_size=30, metric='minkowski',\n",
       "           metric_params=None, n_jobs=None, n_neighbors=5, p=2,\n",
       "           weights='uniform'),\n",
       "       fit_params=None, iid='warn', n_jobs=None,\n",
       "       param_grid=[{'weights': ['uniform', 'distance'], 'n_neighbors': [3, 4, 5]}],\n",
       "       pre_dispatch='2*n_jobs', refit=True, return_train_score='warn',\n",
       "       scoring=None, verbose=3)"
      ]
     },
     "execution_count": 88,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.model_selection import GridSearchCV\n",
    "\n",
    "param_grid = [{'weights': [\"uniform\", \"distance\"], 'n_neighbors': [3, 4, 5]}]\n",
    "\n",
    "knn_clf = KNeighborsClassifier()\n",
    "grid_search = GridSearchCV(knn_clf, param_grid, cv=5, verbose=3)\n",
    "grid_search.fit(X_train, y_train)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 89,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'n_neighbors': 4, 'weights': 'distance'}"
      ]
     },
     "execution_count": 89,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "grid_search.best_params_"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 90,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9716166666666667"
      ]
     },
     "execution_count": 90,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "grid_search.best_score_"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 91,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9714"
      ]
     },
     "execution_count": 91,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.metrics import accuracy_score\n",
    "\n",
    "y_pred = grid_search.predict(X_test)\n",
    "accuracy_score(y_test, y_pred)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 2. Data Augmentation"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 92,
   "metadata": {},
   "outputs": [],
   "source": [
    "from scipy.ndimage.interpolation import shift"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 93,
   "metadata": {},
   "outputs": [],
   "source": [
    "def shift_image(image, dx, dy):\n",
    "    image = image.reshape((28, 28))\n",
    "    shifted_image = shift(image, [dy, dx], cval=0, mode=\"constant\")\n",
    "    return shifted_image.reshape([-1])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 94,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 864x216 with 3 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "image = X_train[1000]\n",
    "shifted_image_down = shift_image(image, 0, 5)\n",
    "shifted_image_left = shift_image(image, -5, 0)\n",
    "\n",
    "plt.figure(figsize=(12,3))\n",
    "plt.subplot(131)\n",
    "plt.title(\"Original\", fontsize=14)\n",
    "plt.imshow(image.reshape(28, 28), interpolation=\"nearest\", cmap=\"Greys\")\n",
    "plt.subplot(132)\n",
    "plt.title(\"Shifted down\", fontsize=14)\n",
    "plt.imshow(shifted_image_down.reshape(28, 28), interpolation=\"nearest\", cmap=\"Greys\")\n",
    "plt.subplot(133)\n",
    "plt.title(\"Shifted left\", fontsize=14)\n",
    "plt.imshow(shifted_image_left.reshape(28, 28), interpolation=\"nearest\", cmap=\"Greys\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 95,
   "metadata": {},
   "outputs": [],
   "source": [
    "X_train_augmented = [image for image in X_train]\n",
    "y_train_augmented = [label for label in y_train]\n",
    "\n",
    "for dx, dy in ((1, 0), (-1, 0), (0, 1), (0, -1)):\n",
    "    for image, label in zip(X_train, y_train):\n",
    "        X_train_augmented.append(shift_image(image, dx, dy))\n",
    "        y_train_augmented.append(label)\n",
    "\n",
    "X_train_augmented = np.array(X_train_augmented)\n",
    "y_train_augmented = np.array(y_train_augmented)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 96,
   "metadata": {},
   "outputs": [],
   "source": [
    "shuffle_idx = np.random.permutation(len(X_train_augmented))\n",
    "X_train_augmented = X_train_augmented[shuffle_idx]\n",
    "y_train_augmented = y_train_augmented[shuffle_idx]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 97,
   "metadata": {},
   "outputs": [],
   "source": [
    "knn_clf = KNeighborsClassifier(**grid_search.best_params_)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 98,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "KNeighborsClassifier(algorithm='auto', leaf_size=30, metric='minkowski',\n",
       "           metric_params=None, n_jobs=None, n_neighbors=4, p=2,\n",
       "           weights='distance')"
      ]
     },
     "execution_count": 98,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "knn_clf.fit(X_train_augmented, y_train_augmented)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 99,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9763"
      ]
     },
     "execution_count": 99,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y_pred = knn_clf.predict(X_test)\n",
    "accuracy_score(y_test, y_pred)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "By simply augmenting the data, we got a 0.5% accuracy boost. :)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 3. Tackle the Titanic dataset"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The goal is to predict whether or not a passenger survived based on attributes such as their age, sex, passenger class, where they embarked and so on."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "First, login to [Kaggle](https://www.kaggle.com/) and go to the [Titanic challenge](https://www.kaggle.com/c/titanic) to download `train.csv` and `test.csv`. Save them to the `datasets/titanic` directory."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Next, let's load the data:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 100,
   "metadata": {},
   "outputs": [],
   "source": [
    "import os\n",
    "\n",
    "TITANIC_PATH = os.path.join(\"datasets\", \"titanic\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 101,
   "metadata": {},
   "outputs": [],
   "source": [
    "import pandas as pd\n",
    "\n",
    "def load_titanic_data(filename, titanic_path=TITANIC_PATH):\n",
    "    csv_path = os.path.join(titanic_path, filename)\n",
    "    return pd.read_csv(csv_path)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 102,
   "metadata": {},
   "outputs": [],
   "source": [
    "train_data = load_titanic_data(\"train.csv\")\n",
    "test_data = load_titanic_data(\"test.csv\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The data is already split into a training set and a test set. However, the test data does *not* contain the labels: your goal is to train the best model you can using the training data, then make your predictions on the test data and upload them to Kaggle to see your final score."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's take a peek at the top few rows of the training set:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 103,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>PassengerId</th>\n",
       "      <th>Survived</th>\n",
       "      <th>Pclass</th>\n",
       "      <th>Name</th>\n",
       "      <th>Sex</th>\n",
       "      <th>Age</th>\n",
       "      <th>SibSp</th>\n",
       "      <th>Parch</th>\n",
       "      <th>Ticket</th>\n",
       "      <th>Fare</th>\n",
       "      <th>Cabin</th>\n",
       "      <th>Embarked</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>3</td>\n",
       "      <td>Braund, Mr. Owen Harris</td>\n",
       "      <td>male</td>\n",
       "      <td>22.0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>A/5 21171</td>\n",
       "      <td>7.2500</td>\n",
       "      <td>NaN</td>\n",
       "      <td>S</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>Cumings, Mrs. John Bradley (Florence Briggs Th...</td>\n",
       "      <td>female</td>\n",
       "      <td>38.0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>PC 17599</td>\n",
       "      <td>71.2833</td>\n",
       "      <td>C85</td>\n",
       "      <td>C</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>3</td>\n",
       "      <td>1</td>\n",
       "      <td>3</td>\n",
       "      <td>Heikkinen, Miss. Laina</td>\n",
       "      <td>female</td>\n",
       "      <td>26.0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>STON/O2. 3101282</td>\n",
       "      <td>7.9250</td>\n",
       "      <td>NaN</td>\n",
       "      <td>S</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>4</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>Futrelle, Mrs. Jacques Heath (Lily May Peel)</td>\n",
       "      <td>female</td>\n",
       "      <td>35.0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>113803</td>\n",
       "      <td>53.1000</td>\n",
       "      <td>C123</td>\n",
       "      <td>S</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>5</td>\n",
       "      <td>0</td>\n",
       "      <td>3</td>\n",
       "      <td>Allen, Mr. William Henry</td>\n",
       "      <td>male</td>\n",
       "      <td>35.0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>373450</td>\n",
       "      <td>8.0500</td>\n",
       "      <td>NaN</td>\n",
       "      <td>S</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   PassengerId  Survived  Pclass  \\\n",
       "0            1         0       3   \n",
       "1            2         1       1   \n",
       "2            3         1       3   \n",
       "3            4         1       1   \n",
       "4            5         0       3   \n",
       "\n",
       "                                                Name     Sex   Age  SibSp  \\\n",
       "0                            Braund, Mr. Owen Harris    male  22.0      1   \n",
       "1  Cumings, Mrs. John Bradley (Florence Briggs Th...  female  38.0      1   \n",
       "2                             Heikkinen, Miss. Laina  female  26.0      0   \n",
       "3       Futrelle, Mrs. Jacques Heath (Lily May Peel)  female  35.0      1   \n",
       "4                           Allen, Mr. William Henry    male  35.0      0   \n",
       "\n",
       "   Parch            Ticket     Fare Cabin Embarked  \n",
       "0      0         A/5 21171   7.2500   NaN        S  \n",
       "1      0          PC 17599  71.2833   C85        C  \n",
       "2      0  STON/O2. 3101282   7.9250   NaN        S  \n",
       "3      0            113803  53.1000  C123        S  \n",
       "4      0            373450   8.0500   NaN        S  "
      ]
     },
     "execution_count": 103,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The attributes have the following meaning:\n",
    "* **Survived**: that's the target, 0 means the passenger did not survive, while 1 means he/she survived.\n",
    "* **Pclass**: passenger class.\n",
    "* **Name**, **Sex**, **Age**: self-explanatory\n",
    "* **SibSp**: how many siblings & spouses of the passenger aboard the Titanic.\n",
    "* **Parch**: how many children & parents of the passenger aboard the Titanic.\n",
    "* **Ticket**: ticket id\n",
    "* **Fare**: price paid (in pounds)\n",
    "* **Cabin**: passenger's cabin number\n",
    "* **Embarked**: where the passenger embarked the Titanic"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's get more info to see how much data is missing:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 104,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<class 'pandas.core.frame.DataFrame'>\n",
      "RangeIndex: 891 entries, 0 to 890\n",
      "Data columns (total 12 columns):\n",
      "PassengerId    891 non-null int64\n",
      "Survived       891 non-null int64\n",
      "Pclass         891 non-null int64\n",
      "Name           891 non-null object\n",
      "Sex            891 non-null object\n",
      "Age            714 non-null float64\n",
      "SibSp          891 non-null int64\n",
      "Parch          891 non-null int64\n",
      "Ticket         891 non-null object\n",
      "Fare           891 non-null float64\n",
      "Cabin          204 non-null object\n",
      "Embarked       889 non-null object\n",
      "dtypes: float64(2), int64(5), object(5)\n",
      "memory usage: 83.6+ KB\n"
     ]
    }
   ],
   "source": [
    "train_data.info()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Okay, the **Age**, **Cabin** and **Embarked** attributes are sometimes null (less than 891 non-null), especially the **Cabin** (77% are null). We will ignore the **Cabin** for now and focus on the rest. The **Age** attribute has about 19% null values, so we will need to decide what to do with them. Replacing null values with the median age seems reasonable."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The **Name** and **Ticket** attributes may have some value, but they will be a bit tricky to convert into useful numbers that a model can consume. So for now, we will ignore them."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's take a look at the numerical attributes:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 105,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>PassengerId</th>\n",
       "      <th>Survived</th>\n",
       "      <th>Pclass</th>\n",
       "      <th>Age</th>\n",
       "      <th>SibSp</th>\n",
       "      <th>Parch</th>\n",
       "      <th>Fare</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>count</th>\n",
       "      <td>891.000000</td>\n",
       "      <td>891.000000</td>\n",
       "      <td>891.000000</td>\n",
       "      <td>714.000000</td>\n",
       "      <td>891.000000</td>\n",
       "      <td>891.000000</td>\n",
       "      <td>891.000000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>mean</th>\n",
       "      <td>446.000000</td>\n",
       "      <td>0.383838</td>\n",
       "      <td>2.308642</td>\n",
       "      <td>29.699118</td>\n",
       "      <td>0.523008</td>\n",
       "      <td>0.381594</td>\n",
       "      <td>32.204208</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>std</th>\n",
       "      <td>257.353842</td>\n",
       "      <td>0.486592</td>\n",
       "      <td>0.836071</td>\n",
       "      <td>14.526497</td>\n",
       "      <td>1.102743</td>\n",
       "      <td>0.806057</td>\n",
       "      <td>49.693429</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>min</th>\n",
       "      <td>1.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>1.000000</td>\n",
       "      <td>0.420000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>25%</th>\n",
       "      <td>223.500000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>2.000000</td>\n",
       "      <td>20.125000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>7.910400</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>50%</th>\n",
       "      <td>446.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>3.000000</td>\n",
       "      <td>28.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>14.454200</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>75%</th>\n",
       "      <td>668.500000</td>\n",
       "      <td>1.000000</td>\n",
       "      <td>3.000000</td>\n",
       "      <td>38.000000</td>\n",
       "      <td>1.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>31.000000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>max</th>\n",
       "      <td>891.000000</td>\n",
       "      <td>1.000000</td>\n",
       "      <td>3.000000</td>\n",
       "      <td>80.000000</td>\n",
       "      <td>8.000000</td>\n",
       "      <td>6.000000</td>\n",
       "      <td>512.329200</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "       PassengerId    Survived      Pclass         Age       SibSp  \\\n",
       "count   891.000000  891.000000  891.000000  714.000000  891.000000   \n",
       "mean    446.000000    0.383838    2.308642   29.699118    0.523008   \n",
       "std     257.353842    0.486592    0.836071   14.526497    1.102743   \n",
       "min       1.000000    0.000000    1.000000    0.420000    0.000000   \n",
       "25%     223.500000    0.000000    2.000000   20.125000    0.000000   \n",
       "50%     446.000000    0.000000    3.000000   28.000000    0.000000   \n",
       "75%     668.500000    1.000000    3.000000   38.000000    1.000000   \n",
       "max     891.000000    1.000000    3.000000   80.000000    8.000000   \n",
       "\n",
       "            Parch        Fare  \n",
       "count  891.000000  891.000000  \n",
       "mean     0.381594   32.204208  \n",
       "std      0.806057   49.693429  \n",
       "min      0.000000    0.000000  \n",
       "25%      0.000000    7.910400  \n",
       "50%      0.000000   14.454200  \n",
       "75%      0.000000   31.000000  \n",
       "max      6.000000  512.329200  "
      ]
     },
     "execution_count": 105,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data.describe()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* Yikes, only 38% **Survived**. :(  That's close enough to 40%, so accuracy will be a reasonable metric to evaluate our model.\n",
    "* The mean **Fare** was £32.20, which does not seem so expensive (but it was probably a lot of money back then).\n",
    "* The mean **Age** was less than 30 years old."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's check that the target is indeed 0 or 1:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 106,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0    549\n",
       "1    342\n",
       "Name: Survived, dtype: int64"
      ]
     },
     "execution_count": 106,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data[\"Survived\"].value_counts()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now let's take a quick look at all the categorical attributes:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 107,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "3    491\n",
       "1    216\n",
       "2    184\n",
       "Name: Pclass, dtype: int64"
      ]
     },
     "execution_count": 107,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data[\"Pclass\"].value_counts()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 108,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "male      577\n",
       "female    314\n",
       "Name: Sex, dtype: int64"
      ]
     },
     "execution_count": 108,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data[\"Sex\"].value_counts()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 109,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "S    644\n",
       "C    168\n",
       "Q     77\n",
       "Name: Embarked, dtype: int64"
      ]
     },
     "execution_count": 109,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data[\"Embarked\"].value_counts()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The Embarked attribute tells us where the passenger embarked: C=Cherbourg, Q=Queenstown, S=Southampton."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note**: the code below uses a mix of `Pipeline`, `FeatureUnion` and a custom `DataFrameSelector` to preprocess some columns differently.  Since Scikit-Learn 0.20, it is preferable to use a `ColumnTransformer`, like in the previous chapter."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now let's build our preprocessing pipelines. We will reuse the `DataframeSelector` we built in the previous chapter to select specific attributes from the `DataFrame`:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 110,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.base import BaseEstimator, TransformerMixin\n",
    "\n",
    "class DataFrameSelector(BaseEstimator, TransformerMixin):\n",
    "    def __init__(self, attribute_names):\n",
    "        self.attribute_names = attribute_names\n",
    "    def fit(self, X, y=None):\n",
    "        return self\n",
    "    def transform(self, X):\n",
    "        return X[self.attribute_names]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's build the pipeline for the numerical attributes:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 111,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.pipeline import Pipeline\n",
    "from sklearn.impute import SimpleImputer\n",
    "\n",
    "num_pipeline = Pipeline([\n",
    "        (\"select_numeric\", DataFrameSelector([\"Age\", \"SibSp\", \"Parch\", \"Fare\"])),\n",
    "        (\"imputer\", SimpleImputer(strategy=\"median\")),\n",
    "    ])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 112,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[22.    ,  1.    ,  0.    ,  7.25  ],\n",
       "       [38.    ,  1.    ,  0.    , 71.2833],\n",
       "       [26.    ,  0.    ,  0.    ,  7.925 ],\n",
       "       ...,\n",
       "       [28.    ,  1.    ,  2.    , 23.45  ],\n",
       "       [26.    ,  0.    ,  0.    , 30.    ],\n",
       "       [32.    ,  0.    ,  0.    ,  7.75  ]])"
      ]
     },
     "execution_count": 112,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "num_pipeline.fit_transform(train_data)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We will also need an imputer for the string categorical columns (the regular `SimpleImputer` does not work on those):"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 113,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Inspired from stackoverflow.com/questions/25239958\n",
    "class MostFrequentImputer(BaseEstimator, TransformerMixin):\n",
    "    def fit(self, X, y=None):\n",
    "        self.most_frequent_ = pd.Series([X[c].value_counts().index[0] for c in X],\n",
    "                                        index=X.columns)\n",
    "        return self\n",
    "    def transform(self, X, y=None):\n",
    "        return X.fillna(self.most_frequent_)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 114,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.preprocessing import OneHotEncoder"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we can build the pipeline for the categorical attributes:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 115,
   "metadata": {},
   "outputs": [],
   "source": [
    "cat_pipeline = Pipeline([\n",
    "        (\"select_cat\", DataFrameSelector([\"Pclass\", \"Sex\", \"Embarked\"])),\n",
    "        (\"imputer\", MostFrequentImputer()),\n",
    "        (\"cat_encoder\", OneHotEncoder(sparse=False)),\n",
    "    ])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 116,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[0., 0., 1., ..., 0., 0., 1.],\n",
       "       [1., 0., 0., ..., 1., 0., 0.],\n",
       "       [0., 0., 1., ..., 0., 0., 1.],\n",
       "       ...,\n",
       "       [0., 0., 1., ..., 0., 0., 1.],\n",
       "       [1., 0., 0., ..., 1., 0., 0.],\n",
       "       [0., 0., 1., ..., 0., 1., 0.]])"
      ]
     },
     "execution_count": 116,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "cat_pipeline.fit_transform(train_data)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, let's join the numerical and categorical pipelines:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 117,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.pipeline import FeatureUnion\n",
    "preprocess_pipeline = FeatureUnion(transformer_list=[\n",
    "        (\"num_pipeline\", num_pipeline),\n",
    "        (\"cat_pipeline\", cat_pipeline),\n",
    "    ])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Cool! Now we have a nice preprocessing pipeline that takes the raw data and outputs numerical input features that we can feed to any Machine Learning model we want."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 118,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[22.,  1.,  0., ...,  0.,  0.,  1.],\n",
       "       [38.,  1.,  0., ...,  1.,  0.,  0.],\n",
       "       [26.,  0.,  0., ...,  0.,  0.,  1.],\n",
       "       ...,\n",
       "       [28.,  1.,  2., ...,  0.,  0.,  1.],\n",
       "       [26.,  0.,  0., ...,  1.,  0.,  0.],\n",
       "       [32.,  0.,  0., ...,  0.,  1.,  0.]])"
      ]
     },
     "execution_count": 118,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X_train = preprocess_pipeline.fit_transform(train_data)\n",
    "X_train"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's not forget to get the labels:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 119,
   "metadata": {},
   "outputs": [],
   "source": [
    "y_train = train_data[\"Survived\"]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We are now ready to train a classifier. Let's start with an `SVC`:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 120,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "SVC(C=1.0, cache_size=200, class_weight=None, coef0=0.0,\n",
       "  decision_function_shape='ovr', degree=3, gamma='auto', kernel='rbf',\n",
       "  max_iter=-1, probability=False, random_state=None, shrinking=True,\n",
       "  tol=0.001, verbose=False)"
      ]
     },
     "execution_count": 120,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.svm import SVC\n",
    "\n",
    "svm_clf = SVC(gamma=\"auto\")\n",
    "svm_clf.fit(X_train, y_train)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Great, our model is trained, let's use it to make predictions on the test set:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 121,
   "metadata": {},
   "outputs": [],
   "source": [
    "X_test = preprocess_pipeline.transform(test_data)\n",
    "y_pred = svm_clf.predict(X_test)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And now we could just build a CSV file with these predictions (respecting the format excepted by Kaggle), then upload it and hope for the best. But wait! We can do better than hope. Why don't we use cross-validation to have an idea of how good our model is?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 122,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7365250822835092"
      ]
     },
     "execution_count": 122,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.model_selection import cross_val_score\n",
    "\n",
    "svm_scores = cross_val_score(svm_clf, X_train, y_train, cv=10)\n",
    "svm_scores.mean()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Okay, over 73% accuracy, clearly better than random chance, but it's not a great score. Looking at the [leaderboard](https://www.kaggle.com/c/titanic/leaderboard) for the Titanic competition on Kaggle, you can see that you need to reach above 80% accuracy to be within the top 10% Kagglers. Some reached 100%, but since you can easily find the [list of victims](https://www.encyclopedia-titanica.org/titanic-victims/) of the Titanic, it seems likely that there was little Machine Learning involved in their performance! ;-) So let's try to build a model that reaches 80% accuracy."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's try a `RandomForestClassifier`:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 123,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.8149526160481217"
      ]
     },
     "execution_count": 123,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.ensemble import RandomForestClassifier\n",
    "\n",
    "forest_clf = RandomForestClassifier(n_estimators=100, random_state=42)\n",
    "forest_scores = cross_val_score(forest_clf, X_train, y_train, cv=10)\n",
    "forest_scores.mean()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "That's much better!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Instead of just looking at the mean accuracy across the 10 cross-validation folds, let's plot all 10 scores for each model, along with a box plot highlighting the lower and upper quartiles, and \"whiskers\" showing the extent of the scores (thanks to Nevin Yilmaz for suggesting this visualization). Note that the `boxplot()` function detects outliers (called \"fliers\") and does not include them within the whiskers. Specifically, if the lower quartile is $Q_1$ and the upper quartile is $Q_3$, then the interquartile range $IQR = Q_3 - Q_1$ (this is the box's height), and any score lower than $Q_1 - 1.5 \\times IQR$ is a flier, and so is any score greater than $Q3 + 1.5 \\times IQR$."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 124,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 576x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(8, 4))\n",
    "plt.plot([1]*10, svm_scores, \".\")\n",
    "plt.plot([2]*10, forest_scores, \".\")\n",
    "plt.boxplot([svm_scores, forest_scores], labels=(\"SVM\",\"Random Forest\"))\n",
    "plt.ylabel(\"Accuracy\", fontsize=14)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To improve this result further, you could:\n",
    "* Compare many more models and tune hyperparameters using cross validation and grid search,\n",
    "* Do more feature engineering, for example:\n",
    "  * replace **SibSp** and **Parch** with their sum,\n",
    "  * try to identify parts of names that correlate well with the **Survived** attribute (e.g. if the name contains \"Countess\", then survival seems more likely),\n",
    "* try to convert numerical attributes to categorical attributes: for example, different age groups had very different survival rates (see below), so it may help to create an age bucket category and use it instead of the age. Similarly, it may be useful to have a special category for people traveling alone since only 30% of them survived (see below)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 125,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Survived</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>AgeBucket</th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0.0</th>\n",
       "      <td>0.576923</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>15.0</th>\n",
       "      <td>0.362745</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>30.0</th>\n",
       "      <td>0.423256</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>45.0</th>\n",
       "      <td>0.404494</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>60.0</th>\n",
       "      <td>0.240000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>75.0</th>\n",
       "      <td>1.000000</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "           Survived\n",
       "AgeBucket          \n",
       "0.0        0.576923\n",
       "15.0       0.362745\n",
       "30.0       0.423256\n",
       "45.0       0.404494\n",
       "60.0       0.240000\n",
       "75.0       1.000000"
      ]
     },
     "execution_count": 125,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data[\"AgeBucket\"] = train_data[\"Age\"] // 15 * 15\n",
    "train_data[[\"AgeBucket\", \"Survived\"]].groupby(['AgeBucket']).mean()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 126,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Survived</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>RelativesOnboard</th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>0.303538</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>0.552795</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>0.578431</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>0.724138</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>0.200000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>0.136364</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>0.333333</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>0.000000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>0.000000</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                  Survived\n",
       "RelativesOnboard          \n",
       "0                 0.303538\n",
       "1                 0.552795\n",
       "2                 0.578431\n",
       "3                 0.724138\n",
       "4                 0.200000\n",
       "5                 0.136364\n",
       "6                 0.333333\n",
       "7                 0.000000\n",
       "10                0.000000"
      ]
     },
     "execution_count": 126,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train_data[\"RelativesOnboard\"] = train_data[\"SibSp\"] + train_data[\"Parch\"]\n",
    "train_data[[\"RelativesOnboard\", \"Survived\"]].groupby(['RelativesOnboard']).mean()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 4. Spam classifier"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "First, let's fetch the data:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 127,
   "metadata": {},
   "outputs": [],
   "source": [
    "import os\n",
    "import tarfile\n",
    "from six.moves import urllib\n",
    "\n",
    "DOWNLOAD_ROOT = \"http://spamassassin.apache.org/old/publiccorpus/\"\n",
    "HAM_URL = DOWNLOAD_ROOT + \"20030228_easy_ham.tar.bz2\"\n",
    "SPAM_URL = DOWNLOAD_ROOT + \"20030228_spam.tar.bz2\"\n",
    "SPAM_PATH = os.path.join(\"datasets\", \"spam\")\n",
    "\n",
    "def fetch_spam_data(spam_url=SPAM_URL, spam_path=SPAM_PATH):\n",
    "    if not os.path.isdir(spam_path):\n",
    "        os.makedirs(spam_path)\n",
    "    for filename, url in ((\"ham.tar.bz2\", HAM_URL), (\"spam.tar.bz2\", SPAM_URL)):\n",
    "        path = os.path.join(spam_path, filename)\n",
    "        if not os.path.isfile(path):\n",
    "            urllib.request.urlretrieve(url, path)\n",
    "        tar_bz2_file = tarfile.open(path)\n",
    "        tar_bz2_file.extractall(path=SPAM_PATH)\n",
    "        tar_bz2_file.close()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 128,
   "metadata": {},
   "outputs": [],
   "source": [
    "fetch_spam_data()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Next, let's load all the emails:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 129,
   "metadata": {},
   "outputs": [],
   "source": [
    "HAM_DIR = os.path.join(SPAM_PATH, \"easy_ham\")\n",
    "SPAM_DIR = os.path.join(SPAM_PATH, \"spam\")\n",
    "ham_filenames = [name for name in sorted(os.listdir(HAM_DIR)) if len(name) > 20]\n",
    "spam_filenames = [name for name in sorted(os.listdir(SPAM_DIR)) if len(name) > 20]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 130,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "2500"
      ]
     },
     "execution_count": 130,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "len(ham_filenames)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 131,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "500"
      ]
     },
     "execution_count": 131,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "len(spam_filenames)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can use Python's `email` module to parse these emails (this handles headers, encoding, and so on):"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 132,
   "metadata": {},
   "outputs": [],
   "source": [
    "import email\n",
    "import email.policy\n",
    "\n",
    "def load_email(is_spam, filename, spam_path=SPAM_PATH):\n",
    "    directory = \"spam\" if is_spam else \"easy_ham\"\n",
    "    with open(os.path.join(spam_path, directory, filename), \"rb\") as f:\n",
    "        return email.parser.BytesParser(policy=email.policy.default).parse(f)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 133,
   "metadata": {},
   "outputs": [],
   "source": [
    "ham_emails = [load_email(is_spam=False, filename=name) for name in ham_filenames]\n",
    "spam_emails = [load_email(is_spam=True, filename=name) for name in spam_filenames]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's look at one example of ham and one example of spam, to get a feel of what the data looks like:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 134,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Martin A posted:\n",
      "Tassos Papadopoulos, the Greek sculptor behind the plan, judged that the\n",
      " limestone of Mount Kerdylio, 70 miles east of Salonika and not far from the\n",
      " Mount Athos monastic community, was ideal for the patriotic sculpture. \n",
      " \n",
      " As well as Alexander's granite features, 240 ft high and 170 ft wide, a\n",
      " museum, a restored amphitheatre and car park for admiring crowds are\n",
      "planned\n",
      "---------------------\n",
      "So is this mountain limestone or granite?\n",
      "If it's limestone, it'll weather pretty fast.\n",
      "\n",
      "------------------------ Yahoo! Groups Sponsor ---------------------~-->\n",
      "4 DVDs Free +s&p Join Now\n",
      "http://us.click.yahoo.com/pt6YBB/NXiEAA/mG3HAA/7gSolB/TM\n",
      "---------------------------------------------------------------------~->\n",
      "\n",
      "To unsubscribe from this group, send an email to:\n",
      "forteana-unsubscribe@egroups.com\n",
      "\n",
      " \n",
      "\n",
      "Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/\n"
     ]
    }
   ],
   "source": [
    "print(ham_emails[1].get_content().strip())"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 135,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Help wanted.  We are a 14 year old fortune 500 company, that is\n",
      "growing at a tremendous rate.  We are looking for individuals who\n",
      "want to work from home.\n",
      "\n",
      "This is an opportunity to make an excellent income.  No experience\n",
      "is required.  We will train you.\n",
      "\n",
      "So if you are looking to be employed from home with a career that has\n",
      "vast opportunities, then go:\n",
      "\n",
      "http://www.basetel.com/wealthnow\n",
      "\n",
      "We are looking for energetic and self motivated people.  If that is you\n",
      "than click on the link and fill out the form, and one of our\n",
      "employement specialist will contact you.\n",
      "\n",
      "To be removed from our link simple go to:\n",
      "\n",
      "http://www.basetel.com/remove.html\n",
      "\n",
      "\n",
      "4139vOLW7-758DoDY1425FRhM1-764SMFc8513fCsLl40\n"
     ]
    }
   ],
   "source": [
    "print(spam_emails[6].get_content().strip())"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Some emails are actually multipart, with images and attachments (which can have their own attachments). Let's look at the various types of structures we have:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 136,
   "metadata": {},
   "outputs": [],
   "source": [
    "def get_email_structure(email):\n",
    "    if isinstance(email, str):\n",
    "        return email\n",
    "    payload = email.get_payload()\n",
    "    if isinstance(payload, list):\n",
    "        return \"multipart({})\".format(\", \".join([\n",
    "            get_email_structure(sub_email)\n",
    "            for sub_email in payload\n",
    "        ]))\n",
    "    else:\n",
    "        return email.get_content_type()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 137,
   "metadata": {},
   "outputs": [],
   "source": [
    "from collections import Counter\n",
    "\n",
    "def structures_counter(emails):\n",
    "    structures = Counter()\n",
    "    for email in emails:\n",
    "        structure = get_email_structure(email)\n",
    "        structures[structure] += 1\n",
    "    return structures"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 138,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[('text/plain', 2408),\n",
       " ('multipart(text/plain, application/pgp-signature)', 66),\n",
       " ('multipart(text/plain, text/html)', 8),\n",
       " ('multipart(text/plain, text/plain)', 4),\n",
       " ('multipart(text/plain)', 3),\n",
       " ('multipart(text/plain, application/octet-stream)', 2),\n",
       " ('multipart(text/plain, text/enriched)', 1),\n",
       " ('multipart(text/plain, application/ms-tnef, text/plain)', 1),\n",
       " ('multipart(multipart(text/plain, text/plain, text/plain), application/pgp-signature)',\n",
       "  1),\n",
       " ('multipart(text/plain, video/mng)', 1),\n",
       " ('multipart(text/plain, multipart(text/plain))', 1),\n",
       " ('multipart(text/plain, application/x-pkcs7-signature)', 1),\n",
       " ('multipart(text/plain, multipart(text/plain, text/plain), text/rfc822-headers)',\n",
       "  1),\n",
       " ('multipart(text/plain, multipart(text/plain, text/plain), multipart(multipart(text/plain, application/x-pkcs7-signature)))',\n",
       "  1),\n",
       " ('multipart(text/plain, application/x-java-applet)', 1)]"
      ]
     },
     "execution_count": 138,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "structures_counter(ham_emails).most_common()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 139,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[('text/plain', 218),\n",
       " ('text/html', 183),\n",
       " ('multipart(text/plain, text/html)', 45),\n",
       " ('multipart(text/html)', 20),\n",
       " ('multipart(text/plain)', 19),\n",
       " ('multipart(multipart(text/html))', 5),\n",
       " ('multipart(text/plain, image/jpeg)', 3),\n",
       " ('multipart(text/html, application/octet-stream)', 2),\n",
       " ('multipart(text/plain, application/octet-stream)', 1),\n",
       " ('multipart(text/html, text/plain)', 1),\n",
       " ('multipart(multipart(text/html), application/octet-stream, image/jpeg)', 1),\n",
       " ('multipart(multipart(text/plain, text/html), image/gif)', 1),\n",
       " ('multipart/alternative', 1)]"
      ]
     },
     "execution_count": 139,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "structures_counter(spam_emails).most_common()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "It seems that the ham emails are more often plain text, while spam has quite a lot of HTML. Moreover, quite a few ham emails are signed using PGP, while no spam is. In short, it seems that the email structure is useful information to have."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now let's take a look at the email headers:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 140,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Return-Path : <12a1mailbot1@web.de>\n",
      "Delivered-To : zzzz@localhost.spamassassin.taint.org\n",
      "Received : from localhost (localhost [127.0.0.1])\tby phobos.labs.spamassassin.taint.org (Postfix) with ESMTP id 136B943C32\tfor <zzzz@localhost>; Thu, 22 Aug 2002 08:17:21 -0400 (EDT)\n",
      "Received : from mail.webnote.net [193.120.211.219]\tby localhost with POP3 (fetchmail-5.9.0)\tfor zzzz@localhost (single-drop); Thu, 22 Aug 2002 13:17:21 +0100 (IST)\n",
      "Received : from dd_it7 ([210.97.77.167])\tby webnote.net (8.9.3/8.9.3) with ESMTP id NAA04623\tfor <zzzz@spamassassin.taint.org>; Thu, 22 Aug 2002 13:09:41 +0100\n",
      "From : 12a1mailbot1@web.de\n",
      "Received : from r-smtp.korea.com - 203.122.2.197 by dd_it7  with Microsoft SMTPSVC(5.5.1775.675.6);\t Sat, 24 Aug 2002 09:42:10 +0900\n",
      "To : dcek1a1@netsgo.com\n",
      "Subject : Life Insurance - Why Pay More?\n",
      "Date : Wed, 21 Aug 2002 20:31:57 -1600\n",
      "MIME-Version : 1.0\n",
      "Message-ID : <0103c1042001882DD_IT7@dd_it7>\n",
      "Content-Type : text/html; charset=\"iso-8859-1\"\n",
      "Content-Transfer-Encoding : quoted-printable\n"
     ]
    }
   ],
   "source": [
    "for header, value in spam_emails[0].items():\n",
    "    print(header,\":\",value)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There's probably a lot of useful information in there, such as the sender's email address (12a1mailbot1@web.de looks fishy), but we will just focus on the `Subject` header:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 141,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'Life Insurance - Why Pay More?'"
      ]
     },
     "execution_count": 141,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "spam_emails[0][\"Subject\"]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Okay, before we learn too much about the data, let's not forget to split it into a training set and a test set:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 142,
   "metadata": {},
   "outputs": [],
   "source": [
    "import numpy as np\n",
    "from sklearn.model_selection import train_test_split\n",
    "\n",
    "X = np.array(ham_emails + spam_emails)\n",
    "y = np.array([0] * len(ham_emails) + [1] * len(spam_emails))\n",
    "\n",
    "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2, random_state=42)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Okay, let's start writing the preprocessing functions. First, we will need a function to convert HTML to plain text. Arguably the best way to do this would be to use the great [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/) library, but I would like to avoid adding another dependency to this project, so let's hack a quick & dirty solution using regular expressions (at the risk of [un̨ho͞ly radiańcé destro҉ying all enli̍̈́̂̈́ghtenment](https://stackoverflow.com/a/1732454/38626)). The following function first drops the `<head>` section, then converts all `<a>` tags to the word HYPERLINK, then it gets rid of all HTML tags, leaving only the plain text. For readability, it also replaces multiple newlines with single newlines, and finally it unescapes html entities (such as `&gt;` or `&nbsp;`):"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 143,
   "metadata": {},
   "outputs": [],
   "source": [
    "import re\n",
    "from html import unescape\n",
    "\n",
    "def html_to_plain_text(html):\n",
    "    text = re.sub('<head.*?>.*?</head>', '', html, flags=re.M | re.S | re.I)\n",
    "    text = re.sub('<a\\s.*?>', ' HYPERLINK ', text, flags=re.M | re.S | re.I)\n",
    "    text = re.sub('<.*?>', '', text, flags=re.M | re.S)\n",
    "    text = re.sub(r'(\\s*\\n)+', '\\n', text, flags=re.M | re.S)\n",
    "    return unescape(text)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's see if it works. This is HTML spam:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 144,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<HTML><HEAD><TITLE></TITLE><META http-equiv=\"Content-Type\" content=\"text/html; charset=windows-1252\"><STYLE>A:link {TEX-DECORATION: none}A:active {TEXT-DECORATION: none}A:visited {TEXT-DECORATION: none}A:hover {COLOR: #0033ff; TEXT-DECORATION: underline}</STYLE><META content=\"MSHTML 6.00.2713.1100\" name=\"GENERATOR\"></HEAD>\n",
      "<BODY text=\"#000000\" vLink=\"#0033ff\" link=\"#0033ff\" bgColor=\"#CCCC99\"><TABLE borderColor=\"#660000\" cellSpacing=\"0\" cellPadding=\"0\" border=\"0\" width=\"100%\"><TR><TD bgColor=\"#CCCC99\" valign=\"top\" colspan=\"2\" height=\"27\">\n",
      "<font size=\"6\" face=\"Arial, Helvetica, sans-serif\" color=\"#660000\">\n",
      "<b>OTC</b></font></TD></TR><TR><TD height=\"2\" bgcolor=\"#6a694f\">\n",
      "<font size=\"5\" face=\"Times New Roman, Times, serif\" color=\"#FFFFFF\">\n",
      "<b>&nbsp;Newsletter</b></font></TD><TD height=\"2\" bgcolor=\"#6a694f\"><div align=\"right\"><font color=\"#FFFFFF\">\n",
      "<b>Discover Tomorrow's Winners&nbsp;</b></font></div></TD></TR><TR><TD height=\"25\" colspan=\"2\" bgcolor=\"#CCCC99\"><table width=\"100%\" border=\"0\"  ...\n"
     ]
    }
   ],
   "source": [
    "html_spam_emails = [email for email in X_train[y_train==1]\n",
    "                    if get_email_structure(email) == \"text/html\"]\n",
    "sample_html_spam = html_spam_emails[7]\n",
    "print(sample_html_spam.get_content().strip()[:1000], \"...\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And this is the resulting plain text:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 145,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "OTC\n",
      " Newsletter\n",
      "Discover Tomorrow's Winners \n",
      "For Immediate Release\n",
      "Cal-Bay (Stock Symbol: CBYI)\n",
      "Watch for analyst \"Strong Buy Recommendations\" and several advisory newsletters picking CBYI.  CBYI has filed to be traded on the OTCBB, share prices historically INCREASE when companies get listed on this larger trading exchange. CBYI is trading around 25 cents and should skyrocket to $2.66 - $3.25 a share in the near future.\n",
      "Put CBYI on your watch list, acquire a position TODAY.\n",
      "REASONS TO INVEST IN CBYI\n",
      "A profitable company and is on track to beat ALL earnings estimates!\n",
      "One of the FASTEST growing distributors in environmental & safety equipment instruments.\n",
      "Excellent management team, several EXCLUSIVE contracts.  IMPRESSIVE client list including the U.S. Air Force, Anheuser-Busch, Chevron Refining and Mitsubishi Heavy Industries, GE-Energy & Environmental Research.\n",
      "RAPIDLY GROWING INDUSTRY\n",
      "Industry revenues exceed $900 million, estimates indicate that there could be as much as $25 billi ...\n"
     ]
    }
   ],
   "source": [
    "print(html_to_plain_text(sample_html_spam.get_content())[:1000], \"...\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Great! Now let's write a function that takes an email as input and returns its content as plain text, whatever its format is:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 146,
   "metadata": {},
   "outputs": [],
   "source": [
    "def email_to_text(email):\n",
    "    html = None\n",
    "    for part in email.walk():\n",
    "        ctype = part.get_content_type()\n",
    "        if not ctype in (\"text/plain\", \"text/html\"):\n",
    "            continue\n",
    "        try:\n",
    "            content = part.get_content()\n",
    "        except: # in case of encoding issues\n",
    "            content = str(part.get_payload())\n",
    "        if ctype == \"text/plain\":\n",
    "            return content\n",
    "        else:\n",
    "            html = content\n",
    "    if html:\n",
    "        return html_to_plain_text(html)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 147,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "OTC\n",
      " Newsletter\n",
      "Discover Tomorrow's Winners \n",
      "For Immediate Release\n",
      "Cal-Bay (Stock Symbol: CBYI)\n",
      "Wat ...\n"
     ]
    }
   ],
   "source": [
    "print(email_to_text(sample_html_spam)[:100], \"...\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's throw in some stemming! For this to work, you need to install the Natural Language Toolkit ([NLTK](http://www.nltk.org/)). It's as simple as running the following command (don't forget to activate your virtualenv first; if you don't have one, you will likely need administrator rights, or use the `--user` option):\n",
    "\n",
    "`$ pip3 install nltk`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 148,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Computations => comput\n",
      "Computation => comput\n",
      "Computing => comput\n",
      "Computed => comput\n",
      "Compute => comput\n",
      "Compulsive => compuls\n"
     ]
    }
   ],
   "source": [
    "try:\n",
    "    import nltk\n",
    "\n",
    "    stemmer = nltk.PorterStemmer()\n",
    "    for word in (\"Computations\", \"Computation\", \"Computing\", \"Computed\", \"Compute\", \"Compulsive\"):\n",
    "        print(word, \"=>\", stemmer.stem(word))\n",
    "except ImportError:\n",
    "    print(\"Error: stemming requires the NLTK module.\")\n",
    "    stemmer = None"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We will also need a way to replace URLs with the word \"URL\". For this, we could use hard core [regular expressions](https://mathiasbynens.be/demo/url-regex) but we will just use the [urlextract](https://github.com/lipoja/URLExtract) library. You can install it with the following command (don't forget to activate your virtualenv first; if you don't have one, you will likely need administrator rights, or use the `--user` option):\n",
    "\n",
    "`$ pip3 install urlextract`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 149,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['github.com', 'https://youtu.be/7Pq-S557XQU?t=3m32s']\n"
     ]
    }
   ],
   "source": [
    "try:\n",
    "    import urlextract # may require an Internet connection to download root domain names\n",
    "    \n",
    "    url_extractor = urlextract.URLExtract()\n",
    "    print(url_extractor.find_urls(\"Will it detect github.com and https://youtu.be/7Pq-S557XQU?t=3m32s\"))\n",
    "except ImportError:\n",
    "    print(\"Error: replacing URLs requires the urlextract module.\")\n",
    "    url_extractor = None"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We are ready to put all this together into a transformer that we will use to convert emails to word counters. Note that we split sentences into words using Python's `split()` method, which uses whitespaces for word boundaries. This works for many written languages, but not all. For example, Chinese and Japanese scripts generally don't use spaces between words, and Vietnamese often uses spaces even between syllables. It's okay in this exercise, because the dataset is (mostly) in English."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 150,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.base import BaseEstimator, TransformerMixin\n",
    "\n",
    "class EmailToWordCounterTransformer(BaseEstimator, TransformerMixin):\n",
    "    def __init__(self, strip_headers=True, lower_case=True, remove_punctuation=True,\n",
    "                 replace_urls=True, replace_numbers=True, stemming=True):\n",
    "        self.strip_headers = strip_headers\n",
    "        self.lower_case = lower_case\n",
    "        self.remove_punctuation = remove_punctuation\n",
    "        self.replace_urls = replace_urls\n",
    "        self.replace_numbers = replace_numbers\n",
    "        self.stemming = stemming\n",
    "    def fit(self, X, y=None):\n",
    "        return self\n",
    "    def transform(self, X, y=None):\n",
    "        X_transformed = []\n",
    "        for email in X:\n",
    "            text = email_to_text(email) or \"\"\n",
    "            if self.lower_case:\n",
    "                text = text.lower()\n",
    "            if self.replace_urls and url_extractor is not None:\n",
    "                urls = list(set(url_extractor.find_urls(text)))\n",
    "                urls.sort(key=lambda url: len(url), reverse=True)\n",
    "                for url in urls:\n",
    "                    text = text.replace(url, \" URL \")\n",
    "            if self.replace_numbers:\n",
    "                text = re.sub(r'\\d+(?:\\.\\d*(?:[eE]\\d+))?', 'NUMBER', text)\n",
    "            if self.remove_punctuation:\n",
    "                text = re.sub(r'\\W+', ' ', text, flags=re.M)\n",
    "            word_counts = Counter(text.split())\n",
    "            if self.stemming and stemmer is not None:\n",
    "                stemmed_word_counts = Counter()\n",
    "                for word, count in word_counts.items():\n",
    "                    stemmed_word = stemmer.stem(word)\n",
    "                    stemmed_word_counts[stemmed_word] += count\n",
    "                word_counts = stemmed_word_counts\n",
    "            X_transformed.append(word_counts)\n",
    "        return np.array(X_transformed)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's try this transformer on a few emails:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 151,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([Counter({'chuck': 1, 'murcko': 1, 'wrote': 1, 'stuff': 1, 'yawn': 1, 'r': 1}),\n",
       "       Counter({'the': 11, 'of': 9, 'and': 8, 'all': 3, 'christian': 3, 'to': 3, 'by': 3, 'jefferson': 2, 'i': 2, 'have': 2, 'superstit': 2, 'one': 2, 'on': 2, 'been': 2, 'ha': 2, 'half': 2, 'rogueri': 2, 'teach': 2, 'jesu': 2, 'some': 1, 'interest': 1, 'quot': 1, 'url': 1, 'thoma': 1, 'examin': 1, 'known': 1, 'word': 1, 'do': 1, 'not': 1, 'find': 1, 'in': 1, 'our': 1, 'particular': 1, 'redeem': 1, 'featur': 1, 'they': 1, 'are': 1, 'alik': 1, 'found': 1, 'fabl': 1, 'mytholog': 1, 'million': 1, 'innoc': 1, 'men': 1, 'women': 1, 'children': 1, 'sinc': 1, 'introduct': 1, 'burnt': 1, 'tortur': 1, 'fine': 1, 'imprison': 1, 'what': 1, 'effect': 1, 'thi': 1, 'coercion': 1, 'make': 1, 'world': 1, 'fool': 1, 'other': 1, 'hypocrit': 1, 'support': 1, 'error': 1, 'over': 1, 'earth': 1, 'six': 1, 'histor': 1, 'american': 1, 'john': 1, 'e': 1, 'remsburg': 1, 'letter': 1, 'william': 1, 'short': 1, 'again': 1, 'becom': 1, 'most': 1, 'pervert': 1, 'system': 1, 'that': 1, 'ever': 1, 'shone': 1, 'man': 1, 'absurd': 1, 'untruth': 1, 'were': 1, 'perpetr': 1, 'upon': 1, 'a': 1, 'larg': 1, 'band': 1, 'dupe': 1, 'import': 1, 'led': 1, 'paul': 1, 'first': 1, 'great': 1, 'corrupt': 1}),\n",
       "       Counter({'url': 5, 's': 3, 'group': 3, 'to': 3, 'in': 2, 'forteana': 2, 'martin': 2, 'an': 2, 'and': 2, 'we': 2, 'is': 2, 'yahoo': 2, 'unsubscrib': 2, 'y': 1, 'adamson': 1, 'wrote': 1, 'for': 1, 'altern': 1, 'rather': 1, 'more': 1, 'factual': 1, 'base': 1, 'rundown': 1, 'on': 1, 'hamza': 1, 'career': 1, 'includ': 1, 'hi': 1, 'belief': 1, 'that': 1, 'all': 1, 'non': 1, 'muslim': 1, 'yemen': 1, 'should': 1, 'be': 1, 'murder': 1, 'outright': 1, 'know': 1, 'how': 1, 'unbias': 1, 'memri': 1, 'don': 1, 't': 1, 'html': 1, 'rob': 1, 'sponsor': 1, 'number': 1, 'dvd': 1, 'free': 1, 'p': 1, 'join': 1, 'now': 1, 'from': 1, 'thi': 1, 'send': 1, 'email': 1, 'your': 1, 'use': 1, 'of': 1, 'subject': 1})],\n",
       "      dtype=object)"
      ]
     },
     "execution_count": 151,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X_few = X_train[:3]\n",
    "X_few_wordcounts = EmailToWordCounterTransformer().fit_transform(X_few)\n",
    "X_few_wordcounts"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This looks about right!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we have the word counts, and we need to convert them to vectors. For this, we will build another transformer whose `fit()` method will build the vocabulary (an ordered list of the most common words) and whose `transform()` method will use the vocabulary to convert word counts to vectors. The output is a sparse matrix."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 152,
   "metadata": {},
   "outputs": [],
   "source": [
    "from scipy.sparse import csr_matrix\n",
    "\n",
    "class WordCounterToVectorTransformer(BaseEstimator, TransformerMixin):\n",
    "    def __init__(self, vocabulary_size=1000):\n",
    "        self.vocabulary_size = vocabulary_size\n",
    "    def fit(self, X, y=None):\n",
    "        total_count = Counter()\n",
    "        for word_count in X:\n",
    "            for word, count in word_count.items():\n",
    "                total_count[word] += min(count, 10)\n",
    "        most_common = total_count.most_common()[:self.vocabulary_size]\n",
    "        self.most_common_ = most_common\n",
    "        self.vocabulary_ = {word: index + 1 for index, (word, count) in enumerate(most_common)}\n",
    "        return self\n",
    "    def transform(self, X, y=None):\n",
    "        rows = []\n",
    "        cols = []\n",
    "        data = []\n",
    "        for row, word_count in enumerate(X):\n",
    "            for word, count in word_count.items():\n",
    "                rows.append(row)\n",
    "                cols.append(self.vocabulary_.get(word, 0))\n",
    "                data.append(count)\n",
    "        return csr_matrix((data, (rows, cols)), shape=(len(X), self.vocabulary_size + 1))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 153,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<3x11 sparse matrix of type '<class 'numpy.int64'>'\n",
       "\twith 20 stored elements in Compressed Sparse Row format>"
      ]
     },
     "execution_count": 153,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "vocab_transformer = WordCounterToVectorTransformer(vocabulary_size=10)\n",
    "X_few_vectors = vocab_transformer.fit_transform(X_few_wordcounts)\n",
    "X_few_vectors"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 154,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[ 6,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0],\n",
       "       [99, 11,  9,  8,  1,  3,  3,  1,  3,  2,  3],\n",
       "       [65,  0,  1,  2,  5,  3,  1,  2,  0,  1,  0]], dtype=int64)"
      ]
     },
     "execution_count": 154,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X_few_vectors.toarray()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "What does this matrix mean? Well, the 64 in the third row, first column, means that the third email contains 64 words that are not part of the vocabulary. The 1 next to it means that the first word in the vocabulary is present once in this email. The 2 next to it means that the second word is present twice, and so on. You can look at the vocabulary to know which words we are talking about. The first word is \"of\", the second word is \"and\", etc."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 155,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'the': 1,\n",
       " 'of': 2,\n",
       " 'and': 3,\n",
       " 'url': 4,\n",
       " 'to': 5,\n",
       " 'all': 6,\n",
       " 'in': 7,\n",
       " 'christian': 8,\n",
       " 'on': 9,\n",
       " 'by': 10}"
      ]
     },
     "execution_count": 155,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "vocab_transformer.vocabulary_"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We are now ready to train our first spam classifier! Let's transform the whole dataset:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 156,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.pipeline import Pipeline\n",
    "\n",
    "preprocess_pipeline = Pipeline([\n",
    "    (\"email_to_wordcount\", EmailToWordCounterTransformer()),\n",
    "    (\"wordcount_to_vector\", WordCounterToVectorTransformer()),\n",
    "])\n",
    "\n",
    "X_train_transformed = preprocess_pipeline.fit_transform(X_train)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note**: to be future-proof, we set `solver=\"lbfgs\"` since this will be the default value in Scikit-Learn 0.22."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 157,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "[Parallel(n_jobs=1)]: Using backend SequentialBackend with 1 concurrent workers.\n",
      "/Users/ageron/.virtualenvs/tf2/lib/python3.6/site-packages/sklearn/linear_model/logistic.py:758: ConvergenceWarning: lbfgs failed to converge. Increase the number of iterations.\n",
      "  \"of iterations.\", ConvergenceWarning)\n",
      "[Parallel(n_jobs=1)]: Done   1 out of   1 | elapsed:    0.1s remaining:    0.0s\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[CV]  ................................................................\n",
      "[CV] .................................... , score=0.985, total=   0.1s\n",
      "[CV]  ................................................................\n",
      "[CV] .................................... , score=0.985, total=   0.1s\n",
      "[CV]  ................................................................\n",
      "[CV] ................................... , score=0.9925, total=   0.1s\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/Users/ageron/.virtualenvs/tf2/lib/python3.6/site-packages/sklearn/linear_model/logistic.py:758: ConvergenceWarning: lbfgs failed to converge. Increase the number of iterations.\n",
      "  \"of iterations.\", ConvergenceWarning)\n",
      "[Parallel(n_jobs=1)]: Done   2 out of   2 | elapsed:    0.2s remaining:    0.0s\n",
      "/Users/ageron/.virtualenvs/tf2/lib/python3.6/site-packages/sklearn/linear_model/logistic.py:758: ConvergenceWarning: lbfgs failed to converge. Increase the number of iterations.\n",
      "  \"of iterations.\", ConvergenceWarning)\n",
      "[Parallel(n_jobs=1)]: Done   3 out of   3 | elapsed:    0.4s finished\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "0.9874999999999999"
      ]
     },
     "execution_count": 157,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.linear_model import LogisticRegression\n",
    "from sklearn.model_selection import cross_val_score\n",
    "\n",
    "log_clf = LogisticRegression(solver=\"lbfgs\", random_state=42)\n",
    "score = cross_val_score(log_clf, X_train_transformed, y_train, cv=3, verbose=3)\n",
    "score.mean()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Over 98.7%, not bad for a first try! :) However, remember that we are using the \"easy\" dataset. You can try with the harder datasets, the results won't be so amazing. You would have to try multiple models, select the best ones and fine-tune them using cross-validation, and so on.\n",
    "\n",
    "But you get the picture, so let's stop now, and just print out the precision/recall we get on the test set:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 158,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Precision: 95.88%\n",
      "Recall: 97.89%\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/Users/ageron/.virtualenvs/tf2/lib/python3.6/site-packages/sklearn/linear_model/logistic.py:758: ConvergenceWarning: lbfgs failed to converge. Increase the number of iterations.\n",
      "  \"of iterations.\", ConvergenceWarning)\n"
     ]
    }
   ],
   "source": [
    "from sklearn.metrics import precision_score, recall_score\n",
    "\n",
    "X_test_transformed = preprocess_pipeline.transform(X_test)\n",
    "\n",
    "log_clf = LogisticRegression(solver=\"lbfgs\", random_state=42)\n",
    "log_clf.fit(X_train_transformed, y_train)\n",
    "\n",
    "y_pred = log_clf.predict(X_test_transformed)\n",
    "\n",
    "print(\"Precision: {:.2f}%\".format(100 * precision_score(y_test, y_pred)))\n",
    "print(\"Recall: {:.2f}%\".format(100 * recall_score(y_test, y_pred)))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "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.6.8"
  },
  "nav_menu": {},
  "toc": {
   "navigate_menu": true,
   "number_sections": true,
   "sideBar": true,
   "threshold": 6,
   "toc_cell": false,
   "toc_section_display": "block",
   "toc_window_display": false
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}