Mini_Project_Naive_Bayes_RH.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Basic Text Classification with Naive Bayes\n",
    "***\n",
    "In the mini-project, you'll learn the basics of text analysis using a subset of movie reviews from the rotten tomatoes database. You'll also use a fundamental technique in Bayesian inference, called Naive Bayes. This mini-project is based on [Lab 10 of Harvard's CS109](https://github.com/cs109/2015lab10) class.  Please free to go to the original lab for additional exercises and solutions."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "%matplotlib inline\n",
    "import matplotlib\n",
    "import numpy as np\n",
    "import scipy as sp\n",
    "import matplotlib as mpl\n",
    "import matplotlib.cm as cm\n",
    "import matplotlib.pyplot as plt\n",
    "import pandas as pd\n",
    "import seaborn as sns\n",
    "from six.moves import range\n",
    "\n",
    "# Setup Pandas\n",
    "pd.set_option('display.width', 500)\n",
    "pd.set_option('display.max_columns', 100)\n",
    "pd.set_option('display.notebook_repr_html', True)\n",
    "\n",
    "# Setup Seaborn\n",
    "sns.set_style(\"whitegrid\")\n",
    "sns.set_context(\"poster\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Table of Contents\n",
    "\n",
    "* [Rotten Tomatoes Dataset](#Rotten-Tomatoes-Dataset)\n",
    "    * [Explore](#Explore)\n",
    "* [The Vector Space Model and a Search Engine](#The-Vector-Space-Model-and-a-Search-Engine)\n",
    "    * [In Code](#In-Code)\n",
    "* [Naive Bayes](#Naive-Bayes)\n",
    "    * [Multinomial Naive Bayes and Other Likelihood Functions](#Multinomial-Naive-Bayes-and-Other-Likelihood-Functions)\n",
    "    * [Picking Hyperparameters for Naive Bayes and Text Maintenance](#Picking-Hyperparameters-for-Naive-Bayes-and-Text-Maintenance)\n",
    "* [Interpretation](#Interpretation)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Rotten Tomatoes Dataset"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style>\n",
       "    .dataframe thead tr:only-child th {\n",
       "        text-align: right;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: left;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>critic</th>\n",
       "      <th>fresh</th>\n",
       "      <th>imdb</th>\n",
       "      <th>publication</th>\n",
       "      <th>quote</th>\n",
       "      <th>review_date</th>\n",
       "      <th>rtid</th>\n",
       "      <th>title</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Derek Adams</td>\n",
       "      <td>fresh</td>\n",
       "      <td>114709</td>\n",
       "      <td>Time Out</td>\n",
       "      <td>So ingenious in concept, design and execution ...</td>\n",
       "      <td>2009-10-04</td>\n",
       "      <td>9559</td>\n",
       "      <td>Toy story</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Richard Corliss</td>\n",
       "      <td>fresh</td>\n",
       "      <td>114709</td>\n",
       "      <td>TIME Magazine</td>\n",
       "      <td>The year's most inventive comedy.</td>\n",
       "      <td>2008-08-31</td>\n",
       "      <td>9559</td>\n",
       "      <td>Toy story</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>David Ansen</td>\n",
       "      <td>fresh</td>\n",
       "      <td>114709</td>\n",
       "      <td>Newsweek</td>\n",
       "      <td>A winning animated feature that has something ...</td>\n",
       "      <td>2008-08-18</td>\n",
       "      <td>9559</td>\n",
       "      <td>Toy story</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>Leonard Klady</td>\n",
       "      <td>fresh</td>\n",
       "      <td>114709</td>\n",
       "      <td>Variety</td>\n",
       "      <td>The film sports a provocative and appealing st...</td>\n",
       "      <td>2008-06-09</td>\n",
       "      <td>9559</td>\n",
       "      <td>Toy story</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>Jonathan Rosenbaum</td>\n",
       "      <td>fresh</td>\n",
       "      <td>114709</td>\n",
       "      <td>Chicago Reader</td>\n",
       "      <td>An entertaining computer-generated, hyperreali...</td>\n",
       "      <td>2008-03-10</td>\n",
       "      <td>9559</td>\n",
       "      <td>Toy story</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "               critic  fresh    imdb     publication                                              quote review_date  rtid      title\n",
       "1         Derek Adams  fresh  114709        Time Out  So ingenious in concept, design and execution ...  2009-10-04  9559  Toy story\n",
       "2     Richard Corliss  fresh  114709   TIME Magazine                  The year's most inventive comedy.  2008-08-31  9559  Toy story\n",
       "3         David Ansen  fresh  114709        Newsweek  A winning animated feature that has something ...  2008-08-18  9559  Toy story\n",
       "4       Leonard Klady  fresh  114709         Variety  The film sports a provocative and appealing st...  2008-06-09  9559  Toy story\n",
       "5  Jonathan Rosenbaum  fresh  114709  Chicago Reader  An entertaining computer-generated, hyperreali...  2008-03-10  9559  Toy story"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "critics = pd.read_csv('./critics.csv')\n",
    "#let's drop rows with missing quotes\n",
    "critics = critics[~critics.quote.isnull()]\n",
    "critics.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Explore"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Number of reviews: 15561\n",
      "Number of critics: 623\n",
      "Number of movies:  1921\n"
     ]
    }
   ],
   "source": [
    "n_reviews = len(critics)\n",
    "n_movies = critics.rtid.unique().size\n",
    "n_critics = critics.critic.unique().size\n",
    "\n",
    "\n",
    "print(\"Number of reviews: {:d}\".format(n_reviews))\n",
    "print(\"Number of critics: {:d}\".format(n_critics))\n",
    "print(\"Number of movies:  {:d}\".format(n_movies))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAwsAAAIcCAYAAAC5AjItAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzs3Xl0FGXC9uG7swFhUWSQfZP5AmFNZBNQCYmgAspOUHYR\nRHEZliEiDMiLjCgGEMIuYkRHFNlkGVRAARFFAugoEZQ1ICBD2BPIVt8fvumXlqehCelUk/yuc3IO\n/VR39Z3ioem7q6rLYVmWJQAAAAD4Ez+7AwAAAADwTZQFAAAAAEaUBQAAAABGlAUAAAAARpQFAAAA\nAEYBdgfIKwkJCXZHAAAAAHxSgwYNjOMFpixI7jcCci4xMVGSFBoaanMS3KqYQ7gZzB/cLOYQbkZ+\nmT/X+lCdw5AAAAAAGFEWAAAAABhRFgAAAAAYURYAAAAAGFEWAAAAABhRFgAAAAAYURYAAAAAGFEW\nAAAAABhRFgAAAAAYURYAAAAAGFEWAAAAABhRFgAAAAAYURYAAAAAGFEWAAAAABhRFgAAAAAYURYA\nAAAAGFEWAAAAABhRFgAAAAAYURYAAAAAGFEWAAAAABhRFgAAAAAYBdgdAABQ8KSlZyoo0P+m1xMa\nGpoLaeyRW9sAALyJsgAAyHNBgf56ZNgKu2PYamVse7sjAMB1cRgSAAAAACPKAgAAAAAjygIAAAAA\nI8oCAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACPKAgAAAAAj\nygIAAAAAI8oCAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACPK\nAgAAAAAjygIAAAAAI8oCAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACPKAgAAAAAjygIAAAAAI8oC\nAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACPKAgAAAAAjygIAAAAAI8oCAAAAACOfKQvr169XeHi4\ny5hlWZo1a5YiIiJUv3599evXT/v27bMpIQAAAFCw+ERZ2LFjh/7+979fNT5jxgzNmjVLTzzxhCZP\nnqzz58+rb9++On/+vA0pAQAAgILF1rKQlpamefPmqXfv3goICHBZduHCBc2fP1/PPvusevfuraio\nKM2fP18XL17Uxx9/bFNiAAAAoOCwtSxs2rRJc+fO1YgRI9SzZ0+XZd9//71SUlIUFRXlHLvtttvU\nuHFjbd68Oa+jAgAAAAVOwPXv4j1169bV+vXrVaJECU2fPt1l2cGDByVJlSpVchmvWLGiNmzYkKPn\nS0xMzNHj4F5qaqokti1yjjlUMIWGhtodwScw7+3HaxBuRkGYP7aWhTJlyrhdduHCBQUFBSkoKMhl\nvGjRorpw4YK3owEAAAAFnq1l4Vosy5LD4TAuczd+PXySlfuymzTbFjnFHEJBxry3H69BuBn5Zf4k\nJCS4XeYT34ZkUrx4caWlpSk9Pd1l/OLFiypevLhNqQAAAICCw2fLQpUqVWRZlo4cOeIyfuTIEVWr\nVs2mVAAAAEDB4bNlITw8XIUKFdK6deucY2fPntW2bdvUtGlTG5MBAAAABYPPnrNQtGhR9ezZU2++\n+ab8/PxUtWpVzZ49W8WKFVPXrl3tjgcAAADkez5bFiRp6NCh8vPz09tvv62UlBSFh4dr4sSJnLMA\nAAAA5AGfKQvPPfecnnvuOZexgIAADR8+XMOHD7cpFQAAAFBw+ew5CwAAAADsRVkAAAAAYERZAAAA\nAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAA\nYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABg\nRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBE\nWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZ\nAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkA\nAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAA\nAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAA\nAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAAYERZAAAAAGBEWQAAAABgRFkAAAAA\nYERZAAAAAGBEWQAAAABg5PNlITMzU/PmzVOrVq0UHh6url27auvWrXbHAgAAAPI9ny8L8+fP15Qp\n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\nunWtixcvOsdiY2Ot8PBwKysry+uZvYGP6eDWoUOHdPToUUVGRjrHAgMDFRERoc2bN1/zse+8844u\nXryonj17ejsmfFRO5k/2HigOXYOUszm0bt063XfffSpfvrxzLDQ0VF999ZXq1Knj9czwHTfzf1i2\nCRMmqG7duurUqZO3YsKH5WQOpaWlKSAgQIULF3aO3X777UpJSblqr9WtgrIAtw4ePChJqlKlist4\npUqVdPjwYWVmZhofd+jQIU2fPl3jx49nl38BlpP5s2fPHgUFBWnq1Klq0qSJ6tevr+eff14nT57M\ni8jwMTmdQ3fddZfi4uLUvHlz1alTRwMHDtRvv/2WF5HhQ3L6f1i2devWaefOnYqJiZHD4fBWTPiw\nnMyhRx99VP7+/oqNjdWZM2f0ww8/KD4+Xq1atVKhQoXyInauoyzArQsXLkiSihYt6jJetGhRZWVl\nKTU19arHWJal0aNHq3379mrYsGGe5IRvysn82bNnj9LS0lS0aFHFxcVp7Nix2rVrl/r06XPLfiKD\nnMvJHEpOTtbSpUu1efNmTZgwQa+//rp+/fVXPfXUU8rIyMiT3PANOZk/V4qPj1eDBg0UHh7utYzw\nbTmZQ5UrV9aIESP09ttvq0mTJuratatKlSqlV199NU8ye0OA3QHgu6z/Pffd3ScqpvFFixbp0KFD\nmjVrllezwfflZP707dtXbdu21T333CNJatSokapXr65u3bppzZo16tChg/cCw+fkZA5lZGQoPT1d\n8+bNU4kSJST98Slgly5d9Nlnn6lNmzbeCwyfkpP5k23//v3atm2b3nzzTa9kw60hJ3No8eLFGj16\ntKKjo/Xwww/r999/17Rp0zRw4EC98847t+QRF+xZgFvFixeXpKu+svLixYvy9/e/qmkfO3ZMkyZN\n0qhRo1S4cGFlZGQ4/6FlZGQoKysrb4LDJ9zo/JGk6tWrO4tCtvr166tEiRJ8o1YBlJM5FBwcrHr1\n6jmLgiTVrVtXJUqU0N69e70bGD4lJ/Mn2/r16xUcHKyWLVt6NSN8W07m0Ny5c9WiRQv9z//8j5o2\nbar27dtr7ty5SkhI0CeffJInuXMbZQFuZR+jl5SU5DKelJSkqlWrXnX/rVu36uLFi3r++edVu3Zt\n1a5dWxMnTpQk1a5dWzNmzPB6ZviOG50/krR69Wp99913LmOWZSktLU0lS5b0Sk74rpzMocqVKxu/\n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\nRK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x104bb7860>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "df = critics.copy()\n",
    "df['fresh'] = df.fresh == 'fresh'\n",
    "grp = df.groupby('critic')\n",
    "counts = grp.critic.count()  # number of reviews by each critic\n",
    "means = grp.fresh.mean()     # average freshness for each critic\n",
    "\n",
    "means[counts > 100].hist(bins=10, edgecolor='w', lw=1)\n",
    "plt.xlabel(\"Average Rating per critic\")\n",
    "plt.ylabel(\"Number of Critics\")\n",
    "plt.yticks([0, 2, 4, 6, 8, 10]);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set I</h3>\n",
    "<br/>\n",
    "<b>Exercise:</b> Look at the histogram above. Tell a story about the average ratings per critic. What shape does the distribution look like? What is interesting about the distribution? What might explain these interesting things?\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "My first impression was that the average rating is distributed bimodally, but it is also possible that data for rating between 0.5 and 0.6 are for some reason missing, in which case, regular normal or binomial distribution would be a possibility. It appears many critics give average rating of ~0.6, but some tend to give out lower scores or higher scores, and there are less number of critics that give out ~0.55 on average or so, which is interesting."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## The Vector Space Model and a Search Engine"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "All the diagrams here are snipped from [*Introduction to Information Retrieval* by Manning et. al.]( http://nlp.stanford.edu/IR-book/) which is a great resource on text processing. For additional information on text mining and natural language processing, see [*Foundations of Statistical Natural Language Processing* by Manning and Schutze](http://nlp.stanford.edu/fsnlp/).\n",
    "\n",
    "Also check out Python packages [`nltk`](http://www.nltk.org/), [`spaCy`](https://spacy.io/), [`pattern`](http://www.clips.ua.ac.be/pattern), and their associated resources. Also see [`word2vec`](https://en.wikipedia.org/wiki/Word2vec).\n",
    "\n",
    "Let us define the vector derived from document $d$ by $\\bar V(d)$. What does this mean? Each document is treated as a vector containing information about the words contained in it. Each vector has the same length and each entry \"slot\" in the vector contains some kind of data about the words that appear in the document such as presence/absence (1/0), count (an integer) or some other statistic. Each vector has the same length because each document shared the same vocabulary across the full collection of documents -- this collection is called a *corpus*.\n",
    "\n",
    "To define the vocabulary, we take a union of all words we have seen in all documents. We then just associate an array index with them. So \"hello\" may be at index 5 and \"world\" at index 99.\n",
    "\n",
    "Suppose we have the following corpus:\n",
    "\n",
    "`A Fox one day spied a beautiful bunch of ripe grapes hanging from a vine trained along the branches of a tree. The grapes seemed ready to burst with juice, and the Fox's mouth watered as he gazed longingly at them.`\n",
    "\n",
    "Suppose we treat each sentence as a document $d$. The vocabulary (often called the *lexicon*) is the following:\n",
    "\n",
    "$V = \\left\\{\\right.$ `a, along, and, as, at, beautiful, branches, bunch, burst, day, fox, fox's, from, gazed, grapes, hanging, he, juice, longingly, mouth, of, one, ready, ripe, seemed, spied, the, them, to, trained, tree, vine, watered, with`$\\left.\\right\\}$\n",
    "\n",
    "Then the document\n",
    "\n",
    "`A Fox one day spied a beautiful bunch of ripe grapes hanging from a vine trained along the branches of a tree`\n",
    "\n",
    "may be represented as the following sparse vector of word counts:\n",
    "\n",
    "$$\\bar V(d) = \\left( 4,1,0,0,0,1,1,1,0,1,1,0,1,0,1,1,0,0,0,0,2,1,0,1,0,0,1,0,0,0,1,1,0,0 \\right)$$\n",
    "\n",
    "or more succinctly as\n",
    "\n",
    "`[(0, 4), (1, 1), (5, 1), (6, 1), (7, 1), (9, 1), (10, 1), (12, 1), (14, 1), (15, 1), (20, 2), (21, 1), (23, 1),`\n",
    "`(26, 1), (30, 1), (31, 1)]`\n",
    "\n",
    "along with a dictionary\n",
    "\n",
    "``\n",
    "{\n",
    "    0: a, 1: along, 5: beautiful, 6: branches, 7: bunch, 9: day, 10: fox, 12: from, 14: grapes, \n",
    "    15: hanging, 19: mouth, 20: of, 21: one, 23: ripe, 24: seemed, 25: spied, 26: the, \n",
    "    30: tree, 31: vine, \n",
    "}\n",
    "``\n",
    "\n",
    "Then, a set of documents becomes, in the usual `sklearn` style, a sparse matrix with rows being sparse arrays representing documents and columns representing the features/words in the vocabulary.\n",
    "\n",
    "Notice that this representation loses the relative ordering of the terms in the document. That is \"cat ate rat\" and \"rat ate cat\" are the same. Thus, this representation is also known as the Bag-Of-Words representation.\n",
    "\n",
    "Here is another example, from the book quoted above, although the matrix is transposed here so that documents are columns:\n",
    "\n",
    "![novel terms](terms.png)\n",
    "\n",
    "Such a matrix is also catted a Term-Document Matrix. Here, the terms being indexed could be stemmed before indexing; for instance, `jealous` and `jealousy` after stemming are the same feature. One could also make use of other \"Natural Language Processing\" transformations in constructing the vocabulary. We could use Lemmatization, which reduces words to lemmas: work, working, worked would all reduce to work. We could remove \"stopwords\" from our vocabulary, such as common words like \"the\". We could look for particular parts of speech, such as adjectives. This is often done in Sentiment Analysis. And so on. It all depends on our application.\n",
    "\n",
    "From the book:\n",
    ">The standard way of quantifying the similarity between two documents $d_1$ and $d_2$  is to compute the cosine similarity of their vector representations $\\bar V(d_1)$ and $\\bar V(d_2)$:\n",
    "\n",
    "$$S_{12} = \\frac{\\bar V(d_1) \\cdot \\bar V(d_2)}{|\\bar V(d_1)| \\times |\\bar V(d_2)|}$$\n",
    "\n",
    "![Vector Space Model](vsm.png)\n",
    "\n",
    "\n",
    ">There is a far more compelling reason to represent documents as vectors: we can also view a query as a vector. Consider the query q = jealous gossip. This query turns into the unit vector $\\bar V(q)$ = (0, 0.707, 0.707) on the three coordinates below. \n",
    "\n",
    "![novel terms](terms2.png)\n",
    "\n",
    ">The key idea now: to assign to each document d a score equal to the dot product:\n",
    "\n",
    "$$\\bar V(q) \\cdot \\bar V(d)$$\n",
    "\n",
    "Then we can use this simple Vector Model as a Search engine."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### In Code"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Original text is\n",
      "Hop on pop\n",
      "Hop off pop\n",
      "Hop Hop hop\n",
      "\n",
      "Transformed text vector is \n",
      "[[1 0 1 1]\n",
      " [1 1 0 1]\n",
      " [3 0 0 0]]\n",
      "\n",
      "Words for each feature:\n",
      "['hop', 'off', 'on', 'pop']\n"
     ]
    }
   ],
   "source": [
    "from sklearn.feature_extraction.text import CountVectorizer\n",
    "\n",
    "text = ['Hop on pop', 'Hop off pop', 'Hop Hop hop']\n",
    "print(\"Original text is\\n{}\".format('\\n'.join(text)))\n",
    "\n",
    "vectorizer = CountVectorizer(min_df=0)\n",
    "\n",
    "# call `fit` to build the vocabulary\n",
    "vectorizer.fit(text)\n",
    "\n",
    "# call `transform` to convert text to a bag of words\n",
    "x = vectorizer.transform(text)\n",
    "\n",
    "# CountVectorizer uses a sparse array to save memory, but it's easier in this assignment to \n",
    "# convert back to a \"normal\" numpy array\n",
    "x = x.toarray()\n",
    "\n",
    "print(\"\")\n",
    "print(\"Transformed text vector is \\n{}\".format(x))\n",
    "\n",
    "# `get_feature_names` tracks which word is associated with each column of the transformed x\n",
    "print(\"\")\n",
    "print(\"Words for each feature:\")\n",
    "print(vectorizer.get_feature_names())\n",
    "\n",
    "# Notice that the bag of words treatment doesn't preserve information about the *order* of words, \n",
    "# just their frequency"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "def make_xy(critics, vectorizer=None):\n",
    "    #Your code here    \n",
    "    if vectorizer is None:\n",
    "        vectorizer = CountVectorizer()\n",
    "    X = vectorizer.fit_transform(critics.quote)\n",
    "    X = X.tocsc()  # some versions of sklearn return COO format\n",
    "    y = (critics.fresh == 'fresh').values.astype(np.int)\n",
    "    return X, y\n",
    "X, y = make_xy(critics)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Naive Bayes"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "From Bayes' Theorem, we have that\n",
    "\n",
    "$$P(c \\vert f) = \\frac{P(c \\cap f)}{P(f)}$$\n",
    "\n",
    "where $c$ represents a *class* or category, and $f$ represents a feature vector, such as $\\bar V(d)$ as above. **We are computing the probability that a document (or whatever we are classifying) belongs to category *c* given the features in the document.** $P(f)$ is really just a normalization constant, so the literature usually writes Bayes' Theorem in context of Naive Bayes as\n",
    "\n",
    "$$P(c \\vert f) \\propto P(f \\vert c) P(c) $$\n",
    "\n",
    "$P(c)$ is called the *prior* and is simply the probability of seeing class $c$. But what is $P(f \\vert c)$? This is the probability that we see feature set $f$ given that this document is actually in class $c$. This is called the *likelihood* and comes from the data. One of the major assumptions of the Naive Bayes model is that the features are *conditionally independent* given the class. While the presence of a particular discriminative word may uniquely identify the document as being part of class $c$ and thus violate general feature independence, conditional independence means that the presence of that term is independent of all the other words that appear *within that class*. This is a very important distinction. Recall that if two events are independent, then:\n",
    "\n",
    "$$P(A \\cap B) = P(A) \\cdot P(B)$$\n",
    "\n",
    "Thus, conditional independence implies\n",
    "\n",
    "$$P(f \\vert c)  = \\prod_i P(f_i | c) $$\n",
    "\n",
    "where $f_i$ is an individual feature (a word in this example).\n",
    "\n",
    "To make a classification, we then choose the class $c$ such that $P(c \\vert f)$ is maximal.\n",
    "\n",
    "There is a small caveat when computing these probabilities. For [floating point underflow](http://nlp.stanford.edu/IR-book/html/htmledition/naive-bayes-text-classification-1.html) we change the product into a sum by going into log space. This is called the LogSumExp trick. So:\n",
    "\n",
    "$$\\log P(f \\vert c)  = \\sum_i \\log P(f_i \\vert c) $$\n",
    "\n",
    "There is another caveat. What if we see a term that didn't exist in the training data? This means that $P(f_i \\vert c) = 0$ for that term, and thus $P(f \\vert c)  = \\prod_i P(f_i | c) = 0$, which doesn't help us at all. Instead of using zeros, we add a small negligible value called $\\alpha$ to each count. This is called Laplace Smoothing.\n",
    "\n",
    "$$P(f_i \\vert c) = \\frac{N_{ic}+\\alpha}{N_c + \\alpha N_i}$$\n",
    "\n",
    "where $N_{ic}$ is the number of times feature $i$ was seen in class $c$, $N_c$ is the number of times class $c$ was seen and $N_i$ is the number of times feature $i$ was seen globally. $\\alpha$ is sometimes called a regularization parameter."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Multinomial Naive Bayes and Other Likelihood Functions\n",
    "\n",
    "Since we are modeling word counts, we are using variation of Naive Bayes called Multinomial Naive Bayes. This is because the likelihood function actually takes the form of the multinomial distribution.\n",
    "\n",
    "$$P(f \\vert c) = \\frac{\\left( \\sum_i f_i \\right)!}{\\prod_i f_i!} \\prod_{f_i} P(f_i \\vert c)^{f_i} \\propto \\prod_{i} P(f_i \\vert c)$$\n",
    "\n",
    "where the nasty term out front is absorbed as a normalization constant such that probabilities sum to 1.\n",
    "\n",
    "There are many other variations of Naive Bayes, all which depend on what type of value $f_i$ takes. If $f_i$ is continuous, we may be able to use *Gaussian Naive Bayes*. First compute the mean and variance for each class $c$. Then the likelihood, $P(f \\vert c)$ is given as follows\n",
    "\n",
    "$$P(f_i = v \\vert c) = \\frac{1}{\\sqrt{2\\pi \\sigma^2_c}} e^{- \\frac{\\left( v - \\mu_c \\right)^2}{2 \\sigma^2_c}}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set II</h3>\n",
    "\n",
    "<p><b>Exercise:</b> Implement a simple Naive Bayes classifier:</p>\n",
    "\n",
    "<ol>\n",
    "<li> split the data set into a training and test set\n",
    "<li> Use `scikit-learn`'s `MultinomialNB()` classifier with default parameters.\n",
    "<li> train the classifier over the training set and test on the test set\n",
    "<li> print the accuracy scores for both the training and the test sets\n",
    "</ol>\n",
    "\n",
    "What do you notice? Is this a good classifier? If not, why not?\n",
    "</div>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy on training set: 0.921251\n",
      "Accuracy on test set: 0.770753\n"
     ]
    }
   ],
   "source": [
    "#your turn\n",
    "from sklearn.model_selection import train_test_split\n",
    "from sklearn.naive_bayes import MultinomialNB\n",
    "from sklearn.metrics import accuracy_score, classification_report\n",
    "\n",
    "# Split the dataset into training and test sets\n",
    "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.25, random_state=0)\n",
    "\n",
    "# Set up a Naive Bayes classifier\n",
    "clf = MultinomialNB()\n",
    "\n",
    "# Train clf\n",
    "clf.fit(X_train, y_train)\n",
    "\n",
    "# Get accuracy score\n",
    "score_train = accuracy_score(y_train, clf.predict(X_train))\n",
    "score_test = accuracy_score(y_test, clf.predict(X_test))\n",
    "print('Accuracy on training set: %f' % score_train)\n",
    "print('Accuracy on test set: %f' % score_test)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The classifier was not so accurate for the test set, although it performed well for the train set it was trained on. It is possible that the model was overfit to the raining set, or that the model parameter has to be optimized, such as the class prior or smoothing parameter (alpha)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Picking Hyperparameters for Naive Bayes and Text Maintenance"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We need to know what value to use for $\\alpha$, and we also need to know which words to include in the vocabulary. As mentioned earlier, some words are obvious stopwords. Other words appear so infrequently that they serve as noise, and other words in addition to stopwords appear so frequently that they may also serve as noise."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "First, let's find an appropriate value for `min_df` for the `CountVectorizer`. `min_df` can be either an integer or a float/decimal. If it is an integer, `min_df` represents the minimum number of documents a word must appear in for it to be included in the vocabulary. If it is a float, it represents the minimum *percentage* of documents a word must appear in to be included in the vocabulary. From the documentation:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    ">min_df: When building the vocabulary ignore terms that have a document frequency strictly lower than the given threshold. This value is also called cut-off in the literature. If float, the parameter represents a proportion of documents, integer absolute counts. This parameter is ignored if vocabulary is not None."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set III</h3>\n",
    "\n",
    "<p><b>Exercise:</b> Construct the cumulative distribution of document frequencies (df). The $x$-axis is a document count $x_i$ and the $y$-axis is the percentage of words that appear less than $x_i$ times. For example, at $x=5$, plot a point representing the percentage or number of words that appear in 5 or fewer documents.</p>\n",
    "\n",
    "<p><b>Exercise:</b> Look for the point at which the curve begins climbing steeply. This may be a good value for `min_df`. If we were interested in also picking `max_df`, we would likely pick the value where the curve starts to plateau. What value did you choose?</p>\n",
    "</div>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\nPh1HR0c6duxIy5YtzV492lzZac/v5ujoyLx585g+fTpLliwhNTWVsmXL0rNnT15//XU6d+7M7t27\njb2n/fr14+TJk0RFRfHTTz/dN6Bu3LgxZcuW5cKFC5kGbO7u7ixbtoyIiAiWLVvG9evXKVeuHH37\n9qVfv35mT+tavnw5y5cvB+7MNy9SpAhVqlQhMDCQt99++4FzsceMGUOlSpVYvXo106dPJy0tDWdn\nZ6ZMmWJyL9KrVy/279/PN998w549e3IUUFerVo233nqLWbNm8ddff1G+fHlGjhxp8kpUgJkzZxIc\nHMwPP/zA1q1bcXFxYe7cucyfP984DQvurL49dOhQoqKiGD9+PGPHjqVhw4YZjtupUyfKlClDVFQU\n0dHRpKSkULlyZUaNGsVbb72lOdPPICvDo1q2UESM1q5dy/Dhw5k0adIjeXezJcyfP5+pU6eydevW\nR/K6LBERERGRZ40ekYhIBjdv3uTrr7+mUaNGCqZFRERERLKgId8iYnTw4EGWLl3Kb7/9xp9//sln\nn31m6SqJiIiIiDy1FFCLiFHhwoXZvXs3+fPnZ+zYsbzyyiuWrpKIiIiIyFNLc6hFREREREREckA9\n1Dlw6NAhS1dBRESecvXq1bN0FcRMatdFRMQcmbXtCqhz6EE3SseOHQOgRo0aT6I6uZqulfl0rcyj\n62Q+XSvzZedaKUDLfcx5AKLfF/PpWplH18l8ulbm07UyT3avU1Ztu1b5FhEREREREckBBdQiIiIi\nIiIiOaCAWkRERERERCQHFFCLiIiIiIiI5IACahEREREREZEcUEAtIiIiIiIikgMKqEVERERERERy\nQAG1iIiIiIiISA4ooBYRERERERHJAQXUIiIiYuK7777D1dXVJM1gMBAREYGHhwe1a9emT58+xMXF\nmZRJTk5m4sSJNGnSBFdXVwICAjh37twDjxcTE8Mbb7xBrVq16NChA7GxsSb5Bw4c4PXXX6du3boE\nBgZy7do1k/yAgADCw8NzeLYiIiI5p4BaREREjA4fPsywYcMypIeFhREREcE777zD559/ztWrV/H1\n9eXq1avGMp988glr165lyJAhTJo0iePHj9O/f39SU1OzPN7evXsJCAigQYMGhIaG4uzsjL+/P0eO\nHAHuBPJDhgzhlVdeISQkhKNHjxIVFWXc/rfffuPQoUP07t37EV4FERER8+SzdAVERETE8pKTk/ny\n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\nL8/nn3/Oq6++ysiRI+nQoQNhYWHGMseOHaNHjx64ubnRsWNHkwfl4eHhdOrUibJlyz7WcxcREcmK\nRVf5PnHiBAUKFKBnz5789ttvFC9eHB8fH/z8/LCysspQPj4+noYNG5qkOTk5GfPq1q1LQEAAAwYM\noF69etjb2xMSEgLcebLetGlTqlWr9kjqfneDnpkbN26YVU4sf61y43ekOt+fpX+mchNdK/Pl9WuV\nnJyMnZ2d8bONjQ1FixblypUr/Pzzz1y/fp2WLVsa84sVK0aDBg3YuXMnffr0yXSfe/bsoUOHDiZt\nvqenJ+vWrePcuXOULl2a8uXLs3fvXurWrcv+/fuND8pPnz7N5s2b2bx582M6YxERkQezWECdmppK\nXFwchQoV4sMPP6RcuXJ8//33TJ8+nZs3b2Y6fCspKYkiRYqYpKV/TkpKAsDFxYXY2FjOnDlDuXLl\nKFSoEImJiSxdupSVK1fy/fffM3v2bKysrAgMDKRJkyaP/2RFRERyubfeeouwsDBatWpFzZo1WbVq\nFadOnWLw4MHEx8cD/3vIna5ChQps37490/1dv36df//9l4oVK5qk3/2gvHTp0gwfPpzAwEAWLFhA\n6dKliYqKAmDWrFl4eXlRokSJR3J+5jwoyesPVbJD18o8uk4ij19Wv1+P6vfPoj3UkZGRlCtXztiY\nNmzYkOvXrzNv3jz69etHgQIFzN6XtfX/Rq8XKFCAqlWrmhynbdu2FC5cmICAAKZPn05aWhr+/v7E\nxMTkqDGuUaPGffPTv5gHlZPHfa1OPrDE0/cdqc4PS79/5tO1Ml92rtWhQ4ced3WeuF69evHjjz+a\nvClj8ODBtGzZkjlz5mBra4utra3JNkWKFDE+8L5XevqDHpR7eHiwa9cuEhIScHJywtbWllOnTrFz\n5062bdvGypUr+fLLL7G3t2fkyJG89NJLj+qURSQHhs978D2ByLPEYgG1jY0Nbm5uGdKbNm3KsmXL\n+PPPPzMMz7azs+PatWsmaemf7x6GdreEhATWrFnDhg0biI2NpUKFCrRq1QqAkJAQduzYQefOnR/F\nKYmIiDwRkZGRtGvXLkOP8ONiMBjw8/MjLi6OTz75hKpVq7Jnzx7CwsKwt7fHYDBkOlULyDI9/ZWX\nWeXf/aC8SJEiJg/KZ86ciZ+fH2fPnuWzzz4jKiqKo0ePMnDgQGJiYjIE9uYw50GJHkCZT9fKPM/m\n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\nx8cHpaWlCAgIQHp6OuLj4yESiRAQEABDQ0OF7deuXQs/Pz+0atUKANCnTx/cu3cPiYmJSExMxMOH\nD9GnT5966w8RERERERE1HQ06oY6Li4O3t7fsc9u2bZGUlISysjIEBwdj165dmDVrFvz9/RW2vXHj\nBs6dO4cpU6bIyqysrLB8+XJs2rQJycnJWLVqlcorjRMREREREREBDWhRsk8//RSffvqpXFl4eDjC\nw8PlypydnbFjx45a9+fo6IgzZ84olI8ePRqjR49+tWCJiIiIiIhI5zXoK9REREREREREDRUTaiIi\nIiIiIqI6aDC3fBMRERFR/Rg1Z7+2QyAiahJ4hZqIiIiIiIioDphQExEREREREdUBE2oiIiIiIiKi\nOmBCTURERERERFQHTKiJiIiIiIiI6oAJNREREREREVEd8LVZRERERE0QX41FRKR5vEJNRERERERE\nVAdMqImIiIiIiIjqgAk1ERERERERUR0woSYiIiIiIiKqAy5KRkTUhCizCNHByDH1EAkRERFR08cr\n1ERERERERER1wCvURERERI0UX41FRKRdvEJNREREREREVAdMqImIiIiIiIjqgAk1ERERERERUR3w\nGWoiIh1T9TOX2XKfuBI4ERERUe14hZqIiIiIiIioDphQExEREREREdUBE2oiIiIiIiKiOuAz1ERE\nREQNGN81TUTUcPEKNREREREREVEd8Ao1EREpUOaKGFcCJyIiIl3HK9REREREREREdcAr1EREVCfq\neK6TV7mJiIioMeMVaiIiIiIiIqI64BVqIiIiIi3jSt5ERI0Tr1ATERERERER1QETaiIiIiIiIqI6\nYEJNREREREREVAdMqImIiIiIiIjqgAk1ERERERERUR1wlW8iIiKiesCVvImImh6tX6HetWsX3n33\nXbi4uMDb2xuXLl2qsX12djb+9a9/wdXVFZ6enhCJRJBKpbL6/Px8+Pn5wdXVFZMmTcKtW7fktt+2\nbRumTJmiia4QERHpPM7rRESkS7R6hTolJQWLFy/GjBkz4OzsjOTkZPj7+2P//v2ws7NTaP/48WNM\nnToV//znPxEVFYVr164hKioK+vr68Pf3BwB89dVXkEgkiIuLQ3JyMhYtWoT//ve/AICSkhLEx8cj\nLi6uXvtJRERVU+aK3cHIMfUQCakD53UiItI1WkuopVIpYmJiMHHiRAQFBQEA3nrrLQwdOhSbN2/G\n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\ngg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x10cc7f518>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Your turn.\n",
    "from matplotlib.ticker import FuncFormatter\n",
    "\n",
    "# Function to turn histogram into percentage instead of fraction\n",
    "def to_percent(y, position):\n",
    "    # Ignore the passed in position. This has the effect of scaling the default\n",
    "    # tick locations.\n",
    "    s = str(100 * y)\n",
    "\n",
    "    # The percent symbol needs escaping in latex\n",
    "    if matplotlib.rcParams['text.usetex'] is True:\n",
    "        return s + r'$\\%$'\n",
    "    else:\n",
    "        return s + '%'\n",
    "\n",
    "\n",
    "\n",
    "# Count the appearance of each word and plot\n",
    "x_appearance = X.sum(axis=1)\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(14, 6))\n",
    "ax1.hist(x_appearance, normed=True, bins=40)\n",
    "ax1.set_xlabel('Number of appearance')\n",
    "ax1.set_ylabel('Frequency')\n",
    "ax1.set_title('Frequency Distribution')\n",
    "\n",
    "ax2.hist(x_appearance, cumulative=True, normed=True, bins=50)\n",
    "ax2.set_xlabel('Number of appearance')\n",
    "ax2.set_ylabel('Cumulative frequency')\n",
    "ax2.set_title('Cumulative Distribution')\n",
    "\n",
    "# Format the y-axis to percentage\n",
    "formatter = FuncFormatter(to_percent)   \n",
    "ax1.yaxis.set_major_formatter(formatter)\n",
    "ax2.yaxis.set_major_formatter(formatter)\n",
    "\n",
    "plt.tight_layout()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "My analysis\n",
    "- Based on the cumulative distribution on the right above, I may pick df_min of 10 and df_max of 30, between which the curveture of the cumulative distribution appears more or less linear"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The parameter $\\alpha$ is chosen to be a small value that simply avoids having zeros in the probability computations. This value can sometimes be chosen arbitrarily with domain expertise, but we will use K-fold cross validation. In K-fold cross-validation, we divide the data into $K$ non-overlapping parts. We train on $K-1$ of the folds and test on the remaining fold. We then iterate, so that each fold serves as the test fold exactly once. The function `cv_score` performs the K-fold cross-validation algorithm for us, but we need to pass a function that measures the performance of the algorithm on each fold. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "from sklearn.model_selection import KFold\n",
    "def cv_score(clf, X, y, scorefunc):\n",
    "    result = 0.\n",
    "    nfold = 5\n",
    "    for train, test in KFold(nfold).split(X): # split data into train/test groups, 5 times\n",
    "        clf.fit(X[train], y[train]) # fit the classifier, passed is as clf.\n",
    "        result += scorefunc(clf, X[test], y[test]) # evaluate score function on held-out data\n",
    "    return result / nfold # average"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We use the log-likelihood as the score here in `scorefunc`. The higher the log-likelihood, the better. Indeed, what we do in `cv_score` above is to implement the cross-validation part of `GridSearchCV`.\n",
    "\n",
    "The custom scoring function `scorefunc` allows us to use different metrics depending on the decision risk we care about (precision, accuracy, profit etc.) directly on the validation set. You will often find people using `roc_auc`, precision, recall, or `F1-score` as the scoring function."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "def log_likelihood(clf, x, y):\n",
    "    prob = clf.predict_log_proba(x)\n",
    "    rotten = y == 0\n",
    "    fresh = ~rotten\n",
    "    return prob[rotten, 0].sum() + prob[fresh, 1].sum()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We'll cross-validate over the regularization parameter $\\alpha$."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's set up the train and test masks first, and then we can run the cross-validation procedure."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "from sklearn.model_selection import train_test_split\n",
    "_, itest = train_test_split(range(critics.shape[0]), train_size=0.7)\n",
    "mask = np.zeros(critics.shape[0], dtype=np.bool)\n",
    "mask[itest] = True"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set IV</h3>\n",
    "\n",
    "<p><b>Exercise:</b> What does using the function `log_likelihood` as the score mean? What are we trying to optimize for?</p>\n",
    "\n",
    "<p><b>Exercise:</b> Without writing any code, what do you think would happen if you choose a value of $\\alpha$ that is too high?</p>\n",
    "\n",
    "<p><b>Exercise:</b> Using the skeleton code below, find the best values of the parameter `alpha`, and use the value of `min_df` you chose in the previous exercise set. Use the `cv_score` function above with the `log_likelihood` function for scoring.</p>\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "1. log_likelihood is basically the log of the probability of observing all the features given the model (parameters). By maximizing the log_likelihood, we're maximizing that probability\n",
    "2. alpha serves as the pseudo-count, so having a very high alpha would highten the baseline level (what is considered to be noise goes up), thus could potentially lose informative features, especially of those with lower frequency."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [],
   "source": [
    "from sklearn.naive_bayes import MultinomialNB\n",
    "\n",
    "#the grid of parameters to search over\n",
    "alphas = [.1, 1, 5, 10, 50]\n",
    "best_min_df = 10 # YOUR TURN: put your value of min_df here.\n",
    "\n",
    "#Find the best value for alpha and min_df, and the best classifier\n",
    "best_alpha = None\n",
    "maxscore=-np.inf\n",
    "for alpha in alphas:        \n",
    "    vectorizer = CountVectorizer(min_df=best_min_df)       \n",
    "    Xthis, ythis = make_xy(critics, vectorizer)\n",
    "    Xtrainthis = Xthis[mask]\n",
    "    ytrainthis = ythis[mask]\n",
    "    \n",
    "    # your turn\n",
    "    # Set up a Naive Bayes classifier\n",
    "    clf = MultinomialNB(alpha=alpha)\n",
    "\n",
    "    scorefunc = log_likelihood\n",
    "    \n",
    "    res = cv_score(clf, Xtrainthis, ytrainthis, scorefunc)\n",
    "    if res > maxscore:\n",
    "        maxscore = res\n",
    "        best_alpha = alpha"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "alpha: 1\n"
     ]
    }
   ],
   "source": [
    "print(\"alpha: {}\".format(best_alpha))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set V: Working with the Best Parameters</h3>\n",
    "\n",
    "<p><b>Exercise:</b> Using the best value of  `alpha` you just found, calculate the accuracy on the training and test sets. Is this classifier better? Why (not)?</p>\n",
    "\n",
    "</div>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy on training data: 0.861426\n",
      "Accuracy on test data:     0.737055\n"
     ]
    }
   ],
   "source": [
    "vectorizer = CountVectorizer(min_df=best_min_df)\n",
    "X, y = make_xy(critics, vectorizer)\n",
    "xtrain=X[mask]\n",
    "ytrain=y[mask]\n",
    "xtest=X[~mask]\n",
    "ytest=y[~mask]\n",
    "\n",
    "clf = MultinomialNB(alpha=best_alpha).fit(xtrain, ytrain)\n",
    "\n",
    "#your turn. Print the accuracy on the test and training dataset\n",
    "training_accuracy = clf.score(xtrain, ytrain)\n",
    "test_accuracy = clf.score(xtest, ytest)\n",
    "\n",
    "print(\"Accuracy on training data: {:2f}\".format(training_accuracy))\n",
    "print(\"Accuracy on test data:     {:2f}\".format(test_accuracy))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[[2676 1569]\n",
      " [1295 5352]]\n"
     ]
    }
   ],
   "source": [
    "from sklearn.metrics import confusion_matrix\n",
    "print(confusion_matrix(ytest, clf.predict(xtest)))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "My analysis\n",
    "- The accuracy score was worse. Default alpha for the MultinomialNB is 1.0, which is the same as the one I used here, so the decrease in accuracy does not come from alpha. The cause is instead the value of df_min that I set, which was likely too high. Lower frequency words (features) may  have descriminating power, and thus df_min should be set lower than 10 (the value I used here)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Interpretation"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### What are the strongly predictive features?\n",
    "\n",
    "We use a neat trick to identify strongly predictive features (i.e. words). \n",
    "\n",
    "* first, create a data set such that each row has exactly one feature. This is represented by the identity matrix.\n",
    "* use the trained classifier to make predictions on this matrix\n",
    "* sort the rows by predicted probabilities, and pick the top and bottom $K$ rows"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Good words\t     P(fresh | word)\n",
      "             delight 0.96\n",
      "              finest 0.96\n",
      "         masterpiece 0.94\n",
      "                town 0.93\n",
      "          remarkable 0.93\n",
      "       extraordinary 0.92\n",
      "          delightful 0.92\n",
      "            chilling 0.92\n",
      "               grown 0.92\n",
      "              future 0.92\n",
      "Bad words\t     P(fresh | word)\n",
      "               video 0.11\n",
      "               sadly 0.11\n",
      "           stretches 0.10\n",
      "            intended 0.10\n",
      "                lame 0.09\n",
      "       disappointing 0.09\n",
      "                dull 0.08\n",
      "             unfunny 0.08\n",
      "               bland 0.07\n",
      "       unfortunately 0.07\n"
     ]
    }
   ],
   "source": [
    "words = np.array(vectorizer.get_feature_names())\n",
    "\n",
    "x = np.eye(xtest.shape[1])\n",
    "probs = clf.predict_log_proba(x)[:, 0]\n",
    "ind = np.argsort(probs)\n",
    "\n",
    "good_words = words[ind[:10]]\n",
    "bad_words = words[ind[-10:]]\n",
    "\n",
    "good_prob = probs[ind[:10]]\n",
    "bad_prob = probs[ind[-10:]]\n",
    "\n",
    "print(\"Good words\\t     P(fresh | word)\")\n",
    "for w, p in zip(good_words, good_prob):\n",
    "    print(\"{:>20}\".format(w), \"{:.2f}\".format(1 - np.exp(p)))\n",
    "    \n",
    "print(\"Bad words\\t     P(fresh | word)\")\n",
    "for w, p in zip(bad_words, bad_prob):\n",
    "    print(\"{:>20}\".format(w), \"{:.2f}\".format(1 - np.exp(p)))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set VI</h3>\n",
    "\n",
    "<p><b>Exercise:</b> Why does this method work? What does the probability for each row in the identity matrix represent</p>\n",
    "\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "My answer\n",
    "- Each row represents a feature, so probability for each row represent the probability of being in the class (fresh) given a certain feature (e.g. intelligent, delight, etc ), that is $$P(c \\vert f_i) $$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The above exercise is an example of *feature selection*. There are many other feature selection methods. A list of feature selection methods available in `sklearn` is [here](http://scikit-learn.org/stable/modules/classes.html#module-sklearn.feature_selection). The most common feature selection technique for text mining is the chi-squared $\\left( \\chi^2 \\right)$ [method](http://nlp.stanford.edu/IR-book/html/htmledition/feature-selectionchi2-feature-selection-1.html)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Prediction Errors\n",
    "\n",
    "We can see mis-predictions as well."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Mis-predicted Rotten quotes\n",
      "---------------------------\n",
      "At best, it is fun. But \"fun\" is not an aesthetic experience: fun remains on the surface. I have nothing against the surface. But it belongs where it is and shouldn't be taken for anything else.\n",
      "\n",
      "Despite great scenery, the distinctive visual ideas of Mr. Scott (Alien, Blade Runner) and the strong dramatic presence of Mr. Bridges, most of White Squall remains listless and tame.\n",
      "\n",
      "Nava, who started his feature-film career with El Norte, is a good director who invariably finds a strong rapport with his actors. He's not much of a writer, though, and he should think twice about creating dialogue for his future projects.\n",
      "\n",
      "If it's to be experienced at all, Return to Paradise is best seen as a lively piece of pulp, not a profound exploration of the vagaries of the human soul.\n",
      "\n",
      "It's a sad day when an actor who's totally, beautifully in touch with his dark side finds himself stuck in a movie that's scared of its own shadow.\n",
      "\n",
      "Mis-predicted Fresh quotes\n",
      "--------------------------\n",
      "Though it's a good half hour too long, this overblown 1993 spin-off of the 60s TV show otherwise adds up to a pretty good suspense thriller.\n",
      "\n",
      "The movie is roughly on the same cinematic level as the Mel Gibson Hamlet, though it tends to get under your skin a little more once it gets rolling.\n",
      "\n",
      "The movie has never really been about gold but about character, and Bogart fearlessly makes Fred C. Dobbs into a pathetic, frightened, selfish man -- so sick we would be tempted to pity him, if he were not so undeserving of pity.\n",
      "\n",
      "Some of the gags don't work, but fewer than in any previous Brooks film that I've seen, and when the jokes are meant to be bad, they are riotously poor. What more can one ask of Mel Brooks?\n",
      "\n",
      "The gangland plot is flimsy (bad guy Peter Greene wears too much eyeliner), and the jokes are erratic, but it's a far better showcase for Carrey's comic-from-Uranus talent than Ace Ventura.\n",
      "\n"
     ]
    }
   ],
   "source": [
    "x, y = make_xy(critics, vectorizer)\n",
    "\n",
    "prob = clf.predict_proba(x)[:, 0]\n",
    "predict = clf.predict(x)\n",
    "\n",
    "bad_rotten = np.argsort(prob[y == 0])[:5]\n",
    "bad_fresh = np.argsort(prob[y == 1])[-5:]\n",
    "\n",
    "print(\"Mis-predicted Rotten quotes\")\n",
    "print('---------------------------')\n",
    "for row in bad_rotten:\n",
    "    print(critics[y == 0].quote.iloc[row])\n",
    "    print(\"\")\n",
    "\n",
    "print(\"Mis-predicted Fresh quotes\")\n",
    "print('--------------------------')\n",
    "for row in bad_fresh:\n",
    "    print(critics[y == 1].quote.iloc[row])\n",
    "    print(\"\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set VII: Predicting the Freshness for a New Review</h3>\n",
    "<br/>\n",
    "<div>\n",
    "<b>Exercise:</b>\n",
    "<ul>\n",
    "<li> Using your best trained classifier, predict the freshness of the following sentence: *'This movie is not remarkable, touching, or superb in any way'*\n",
    "<li> Is the result what you'd expect? Why (not)?\n",
    "</ul>\n",
    "</div>\n",
    "</div>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[ 0.00553436,  0.99446564]])"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "clf.predict_proba(vectorizer.transform(['This movie is not remarkable, touching, or superb in any way']))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "My comment\n",
    "- Result would be expected be 'rotten' if a human read it because of the word 'not,' which negates all the other positive words. The model doesn't recognized that and thus classified is as 'fresh' because it contains highly predictable words like remarkable."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Aside: TF-IDF Weighting for Term Importance\n",
    "\n",
    "TF-IDF stands for \n",
    "\n",
    "`Term-Frequency X Inverse Document Frequency`.\n",
    "\n",
    "In the standard `CountVectorizer` model above, we used just the term frequency in a document of words in our vocabulary. In TF-IDF, we weight this term frequency by the inverse of its popularity in all documents. For example, if the word \"movie\" showed up in all the documents, it would not have much predictive value. It could actually be considered a stopword. By weighing its counts by 1 divided by its overall frequency, we downweight it. We can then use this TF-IDF weighted features as inputs to any classifier. **TF-IDF is essentially a measure of term importance, and of how discriminative a word is in a corpus.** There are a variety of nuances involved in computing TF-IDF, mainly involving where to add the smoothing term to avoid division by 0, or log of 0 errors. The formula for TF-IDF in `scikit-learn` differs from that of most textbooks: \n",
    "\n",
    "$$\\mbox{TF-IDF}(t, d) = \\mbox{TF}(t, d)\\times \\mbox{IDF}(t) = n_{td} \\log{\\left( \\frac{\\vert D \\vert}{\\vert d : t \\in d \\vert} + 1 \\right)}$$\n",
    "\n",
    "where $n_{td}$ is the number of times term $t$ occurs in document $d$, $\\vert D \\vert$ is the number of documents, and $\\vert d : t \\in d \\vert$ is the number of documents that contain $t$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# http://scikit-learn.org/dev/modules/feature_extraction.html#text-feature-extraction\n",
    "# http://scikit-learn.org/dev/modules/classes.html#text-feature-extraction-ref\n",
    "from sklearn.feature_extraction.text import TfidfVectorizer\n",
    "tfidfvectorizer = TfidfVectorizer(min_df=1, stop_words='english')\n",
    "Xtfidf=tfidfvectorizer.fit_transform(critics.quote)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div class=\"span5 alert alert-info\">\n",
    "<h3>Exercise Set VIII: Enrichment</h3>\n",
    "\n",
    "<p>\n",
    "There are several additional things we could try. Try some of these as exercises:\n",
    "<ol>\n",
    "<li> Build a Naive Bayes model where the features are n-grams instead of words. N-grams are phrases containing n words next to each other: a bigram contains 2 words, a trigram contains 3 words, and 6-gram contains 6 words. This is useful because \"not good\" and \"so good\" mean very different things. On the other hand, as n increases, the model does not scale well since the feature set becomes more sparse.\n",
    "<li> Try a model besides Naive Bayes, one that would allow for interactions between words -- for example, a Random Forest classifier.\n",
    "<li> Try adding supplemental features -- information about genre, director, cast, etc.\n",
    "<li> Use word2vec or [Latent Dirichlet Allocation](https://en.wikipedia.org/wiki/Latent_Dirichlet_allocation) to group words into topics and use those topics for prediction.\n",
    "<li> Use TF-IDF weighting instead of word counts.\n",
    "</ol>\n",
    "</p>\n",
    "\n",
    "<b>Exercise:</b> Try a few of these ideas to improve the model (or any other ideas of your own). Implement here and report on the result.\n",
    "</div>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy on training data using up to 3grams: 0.980510\n",
      "Accuracy on test data using up to 3grams:     0.740819\n",
      "Accuracy on training data using Random Forest: 0.988863\n",
      "Accuracy on test data using Random Forest:     0.660118\n",
      "Accuracy on training data using decision tree: 1.000000\n",
      "Accuracy on test data using up to decision tree:     0.621373\n"
     ]
    }
   ],
   "source": [
    "# Your turn\n",
    "from sklearn.ensemble import RandomForestClassifier\n",
    "from sklearn.tree import DecisionTreeClassifier\n",
    "\n",
    "# try using higher grams\n",
    "vectorizer = CountVectorizer(min_df=2, ngram_range=(1,3))\n",
    "X, y = make_xy(critics, vectorizer)\n",
    "xtrain=X[mask]\n",
    "ytrain=y[mask]\n",
    "xtest=X[~mask]\n",
    "ytest=y[~mask]\n",
    "\n",
    "clf = MultinomialNB().fit(xtrain, ytrain)\n",
    "\n",
    "training_accuracy = clf.score(xtrain, ytrain)\n",
    "test_accuracy = clf.score(xtest, ytest)\n",
    "print(\"Accuracy on training data using up to 3grams: {:2f}\".format(training_accuracy))\n",
    "print(\"Accuracy on test data using up to 3grams:     {:2f}\".format(test_accuracy))\n",
    "\n",
    "# Try Random Forest Classifier instead\n",
    "clf2 = RandomForestClassifier()\n",
    "clf2.fit(xtrain, ytrain)\n",
    "\n",
    "training_accuracy2 = clf2.score(xtrain, ytrain)\n",
    "test_accuracy2 = clf2.score(xtest, ytest)\n",
    "print(\"Accuracy on training data using Random Forest: {:2f}\".format(training_accuracy2))\n",
    "print(\"Accuracy on test data using Random Forest:     {:2f}\".format(test_accuracy2))\n",
    "\n",
    "# Try decision tree classifier\n",
    "clf3 = DecisionTreeClassifier().fit(xtrain, ytrain)\n",
    "\n",
    "training_accuracy = clf3.score(xtrain, ytrain)\n",
    "test_accuracy = clf3.score(xtest, ytest)\n",
    "print(\"Accuracy on training data using decision tree: {:2f}\".format(training_accuracy))\n",
    "print(\"Accuracy on test data using up to decision tree:     {:2f}\".format(test_accuracy))"
   ]
  }
 ],
 "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.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}