2-svd-nmf-topic-modeling.ipynb

{
  "nbformat": 4,
  "nbformat_minor": 0,
  "metadata": {
    "kernelspec": {
      "name": "python3",
      "display_name": "Python 3"
    },
    "language_info": {
      "codemirror_mode": {
        "name": "ipython",
        "version": 3
      },
      "file_extension": ".py",
      "mimetype": "text/x-python",
      "name": "python",
      "nbconvert_exporter": "python",
      "pygments_lexer": "ipython3",
      "version": "3.7.3"
    },
    "colab": {
      "name": "2-svd-nmf-topic-modeling.ipynb",
      "version": "0.3.2",
      "provenance": [],
      "include_colab_link": true
    },
    "accelerator": "GPU"
  },
  "cells": [
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "view-in-github",
        "colab_type": "text"
      },
      "source": [
        "<a href=\"https://colab.research.google.com/github/javiber/course-nlp/blob/master/2-svd-nmf-topic-modeling.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "I6rbhWzcomAH",
        "colab_type": "text"
      },
      "source": [
        "# Topic Modeling with NMF and SVD"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "pn3tUV98omAK",
        "colab_type": "text"
      },
      "source": [
        "## The problem"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "vBAvihMsomAM",
        "colab_type": "text"
      },
      "source": [
        "Topic modeling is a fun way to start our study of NLP. We will use two popular **matrix decomposition techniques**. \n",
        "\n",
        "We start with a **term-document matrix**:\n",
        "\n",
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/document_term.png?raw=1\" alt=\"term-document matrix\" style=\"width: 80%\"/>\n",
        "\n",
        "source: [Introduction to Information Retrieval](http://player.slideplayer.com/15/4528582/#)\n",
        "\n",
        "We can decompose this into one tall thin matrix times one wide short matrix (possibly with a diagonal matrix in between).\n",
        "\n",
        "Notice that this representation does not take into account word order or sentence structure.  It's an example of a **bag of words** approach."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "sV43P4yxomAN",
        "colab_type": "text"
      },
      "source": [
        "Latent Semantic Analysis (LSA) uses Singular Value Decomposition (SVD)."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "_4tHQ4ZwomAO",
        "colab_type": "text"
      },
      "source": [
        "### Motivation"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Sp6B92UqomAP",
        "colab_type": "text"
      },
      "source": [
        "Consider the most extreme case - reconstructing the matrix using an outer product of two vectors. Clearly, in most cases we won't be able to reconstruct the matrix exactly. But if we had one vector with the relative frequency of each vocabulary word out of the total word count, and one with the average number of words per document, then that outer product would be as close as we can get.\n",
        "\n",
        "Now consider increasing that matrices to two columns and two rows. The optimal decomposition would now be to cluster the documents into two groups, each of which has as different a distribution of words as possible to each other, but as similar as possible amongst the documents in the cluster. We will call those two groups \"topics\". And we would cluster the words into two groups, based on those which most frequently appear in each of the topics. "
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "u98rKTZVomAQ",
        "colab_type": "text"
      },
      "source": [
        "## Getting started"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "aZOYs0x_omAR",
        "colab_type": "text"
      },
      "source": [
        "We'll take a dataset of documents in several different categories, and find topics (consisting of groups of words) for them.  Knowing the actual categories helps us evaluate if the topics we find make sense.\n",
        "\n",
        "We will try this with two different matrix factorizations: **Singular Value Decomposition (SVD)** and **Non-negative Matrix Factorization (NMF)**"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "KWLh1A46omAS",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "import numpy as np\n",
        "from sklearn.datasets import fetch_20newsgroups\n",
        "from sklearn import decomposition\n",
        "from scipy import linalg\n",
        "import matplotlib.pyplot as plt"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "uD8wSPZ9omAX",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "%matplotlib inline\n",
        "np.set_printoptions(suppress=True)"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "YIhMFkNbomAa",
        "colab_type": "text"
      },
      "source": [
        "### Additional Resources"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "jVzxzyMdomAb",
        "colab_type": "text"
      },
      "source": [
        "- [Data source](http://scikit-learn.org/stable/datasets/twenty_newsgroups.html): Newsgroups are discussion groups on Usenet, which was popular in the 80s and 90s before the web really took off.  This dataset includes 18,000 newsgroups posts with 20 topics.\n",
        "- [Chris Manning's book chapter](https://nlp.stanford.edu/IR-book/pdf/18lsi.pdf) on matrix factorization and LSI \n",
        "- Scikit learn [truncated SVD LSI details](http://scikit-learn.org/stable/modules/decomposition.html#lsa)\n",
        "\n",
        "### Other Tutorials\n",
        "- [Scikit-Learn: Out-of-core classification of text documents](http://scikit-learn.org/stable/auto_examples/applications/plot_out_of_core_classification.html): uses [Reuters-21578](https://archive.ics.uci.edu/ml/datasets/reuters-21578+text+categorization+collection) dataset (Reuters articles labeled with ~100 categories), HashingVectorizer\n",
        "- [Text Analysis with Topic Models for the Humanities and Social Sciences](https://de.dariah.eu/tatom/index.html): uses [British and French Literature dataset](https://de.dariah.eu/tatom/datasets.html) of Jane Austen, Charlotte Bronte, Victor Hugo, and more"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "gqGJYvNbomAc",
        "colab_type": "text"
      },
      "source": [
        "## Look at our data"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "zIbCLzaoomAd",
        "colab_type": "text"
      },
      "source": [
        "Scikit Learn comes with a number of built-in datasets, as well as loading utilities to load several standard external datasets. This is a [great resource](http://scikit-learn.org/stable/datasets/), and the datasets include Boston housing prices, face images, patches of forest, diabetes, breast cancer, and more.  We will be using the newsgroups dataset.\n",
        "\n",
        "Newsgroups are discussion groups on Usenet, which was popular in the 80s and 90s before the web really took off.  This dataset includes 18,000 newsgroups posts with 20 topics.  "
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "CRDyqd9eomAe",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "categories = ['alt.atheism', 'talk.religion.misc', 'comp.graphics', 'sci.space']\n",
        "remove = ('headers', 'footers', 'quotes')\n",
        "newsgroups_train = fetch_20newsgroups(subset='train', categories=categories, remove=remove)\n",
        "newsgroups_test = fetch_20newsgroups(subset='test', categories=categories, remove=remove)"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "1jhxHQDVomAh",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "115c5743-8b9f-404f-efcd-21bf06e629cf"
      },
      "source": [
        "newsgroups_train.filenames.shape, newsgroups_train.target.shape"
      ],
      "execution_count": 4,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "((2034,), (2034,))"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 4
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "36S39FEXomAn",
        "colab_type": "text"
      },
      "source": [
        "Let's look at some of the data.  Can you guess which category these messages are in?"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "m9xkPW1EomAo",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 683
        },
        "outputId": "4d8abc97-6899-4a1d-ce7c-3072cc514a06"
      },
      "source": [
        "print(\"\\n--\\n\".join(newsgroups_train.data[:3]))"
      ],
      "execution_count": 6,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "Hi,\n",
            "\n",
            "I've noticed that if you only save a model (with all your mapping planes\n",
            "positioned carefully) to a .3DS file that when you reload it after restarting\n",
            "3DS, they are given a default position and orientation.  But if you save\n",
            "to a .PRJ file their positions/orientation are preserved.  Does anyone\n",
            "know why this information is not stored in the .3DS file?  Nothing is\n",
            "explicitly said in the manual about saving texture rules in the .PRJ file. \n",
            "I'd like to be able to read the texture rule information, does anyone have \n",
            "the format for the .PRJ file?\n",
            "\n",
            "Is the .CEL file format available from somewhere?\n",
            "\n",
            "Rych\n",
            "--\n",
            "\n",
            "\n",
            "Seems to be, barring evidence to the contrary, that Koresh was simply\n",
            "another deranged fanatic who thought it neccessary to take a whole bunch of\n",
            "folks with him, children and all, to satisfy his delusional mania. Jim\n",
            "Jones, circa 1993.\n",
            "\n",
            "\n",
            "Nope - fruitcakes like Koresh have been demonstrating such evil corruption\n",
            "for centuries.\n",
            "--\n",
            "\n",
            " >In article <1993Apr19.020359.26996@sq.sq.com>, msb@sq.sq.com (Mark Brader) \n",
            "\n",
            "MB>                                                             So the\n",
            "MB> 1970 figure seems unlikely to actually be anything but a perijove.\n",
            "\n",
            "JG>Sorry, _perijoves_...I'm not used to talking this language.\n",
            "\n",
            "Couldn't we just say periapsis or apoapsis?\n",
            "\n",
            " \n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "xGK-52m6omAt",
        "colab_type": "text"
      },
      "source": [
        "hint: definition of *perijove* is the point in the orbit of a satellite of Jupiter nearest the planet's center "
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "dfYwvKinomAu",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "c10cb8f3-84ef-47f3-accd-29d64b06298a"
      },
      "source": [
        "np.array(newsgroups_train.target_names)[newsgroups_train.target[:3]]"
      ],
      "execution_count": 7,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "array(['comp.graphics', 'talk.religion.misc', 'sci.space'], dtype='<U18')"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 7
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Mi_MkVBsomAy",
        "colab_type": "text"
      },
      "source": [
        "The target attribute is the integer index of the category."
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "Xj2XW4muomAz",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "e5972cf1-d74f-42a5-c73c-89ffa7dd4f01"
      },
      "source": [
        "newsgroups_train.target[:10]"
      ],
      "execution_count": 10,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "array([1, 3, 2, 0, 2, 0, 2, 1, 2, 1])"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 10
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "EFbuRXJQomA4",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "num_topics, num_top_words = 6, 8"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "KujdsQ0SomA7",
        "colab_type": "text"
      },
      "source": [
        "## Stop words, stemming, lemmatization"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "key9Q4G6omA8",
        "colab_type": "text"
      },
      "source": [
        "### Stop words"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "n7oAqFDromA9",
        "colab_type": "text"
      },
      "source": [
        "From [Intro to Information Retrieval](https://nlp.stanford.edu/IR-book/html/htmledition/dropping-common-terms-stop-words-1.html):\n",
        "\n",
        "*Some extremely common words which would appear to be of little value in helping select documents matching a user need are excluded from the vocabulary entirely. These words are called stop words.*\n",
        "\n",
        "*The general trend in IR systems over time has been from standard use of quite large stop lists (200-300 terms) to very small stop lists (7-12 terms) to no stop list whatsoever. Web search engines generally do not use stop lists.*"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "rxfh59KTomA-",
        "colab_type": "text"
      },
      "source": [
        "#### NLTK"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "fNOZSj4aomA_",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 377
        },
        "outputId": "151a71e7-711e-48f9-8a51-bc4b30c7a5a9"
      },
      "source": [
        "from sklearn.feature_extraction import stop_words\n",
        "\n",
        "sorted(list(stop_words.ENGLISH_STOP_WORDS))[:20]"
      ],
      "execution_count": 32,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['a',\n",
              " 'about',\n",
              " 'above',\n",
              " 'across',\n",
              " 'after',\n",
              " 'afterwards',\n",
              " 'again',\n",
              " 'against',\n",
              " 'all',\n",
              " 'almost',\n",
              " 'alone',\n",
              " 'along',\n",
              " 'already',\n",
              " 'also',\n",
              " 'although',\n",
              " 'always',\n",
              " 'am',\n",
              " 'among',\n",
              " 'amongst',\n",
              " 'amoungst']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 32
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "3wEC3exYomBD",
        "colab_type": "text"
      },
      "source": [
        "There is no single universal list of stop words."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "aaXM6_h8omBE",
        "colab_type": "text"
      },
      "source": [
        "### Stemming and Lemmatization"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "doYYUBrxomBF",
        "colab_type": "text"
      },
      "source": [
        "from [Information Retrieval](https://nlp.stanford.edu/IR-book/html/htmledition/stemming-and-lemmatization-1.html) textbook:\n",
        "\n",
        "Are the below words the same?\n",
        "\n",
        "*organize, organizes, and organizing*\n",
        "\n",
        "*democracy, democratic, and democratization*"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "chrZYSZtomBG",
        "colab_type": "text"
      },
      "source": [
        "Stemming and Lemmatization both generate the root form of the words. \n",
        "\n",
        "Lemmatization uses the rules about a language.  The resulting tokens are all actual words\n",
        "\n",
        "\"Stemming is the poor-man’s lemmatization.\" (Noah Smith, 2011) Stemming is a crude heuristic that chops the ends off of words.  The resulting tokens may not be actual words. Stemming is faster."
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "YSgHnOO5omBH",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 71
        },
        "outputId": "3f49a0d5-2637-4c83-fa4e-6ca1209f2c5e"
      },
      "source": [
        "import nltk\n",
        "nltk.download('wordnet')"
      ],
      "execution_count": 12,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "[nltk_data] Downloading package wordnet to /root/nltk_data...\n",
            "[nltk_data]   Unzipping corpora/wordnet.zip.\n"
          ],
          "name": "stdout"
        },
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "True"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 12
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "6VdBPmzBomBM",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "from nltk import stem"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "vAUBeHxAomBQ",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "wnl = stem.WordNetLemmatizer()\n",
        "porter = stem.porter.PorterStemmer()"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "CdHBhB4komBV",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "word_list = ['feet', 'foot', 'foots', 'footing']"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "Y-UsaZ1-omBZ",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "dd6ef109-5778-444b-88da-b935fdf8b9b7"
      },
      "source": [
        "[wnl.lemmatize(word) for word in word_list]"
      ],
      "execution_count": 16,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['foot', 'foot', 'foot', 'footing']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 16
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "NXeeQC_iomBd",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "b0f703c3-49ca-40f4-a8a0-ae6b3fb60640"
      },
      "source": [
        "[porter.stem(word) for word in word_list]"
      ],
      "execution_count": 17,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['feet', 'foot', 'foot', 'foot']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 17
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "SxkkhIZZomBh",
        "colab_type": "text"
      },
      "source": [
        "Your turn!  Now, try lemmatizing and stemming the following collections of words:\n",
        "\n",
        "- fly, flies, flying\n",
        "- organize, organizes, organizing\n",
        "- universe, university"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "1gbnWXqQs0dT",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "aba9b86b-0444-4d71-91ce-e424a614d86a"
      },
      "source": [
        "l = [\"fly\", \"flies\", \"flying\"]\n",
        "[wnl.lemmatize(x) for x in l], [porter.stem(x) for x in l]"
      ],
      "execution_count": 18,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(['fly', 'fly', 'flying'], ['fli', 'fli', 'fli'])"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 18
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "cbwBa4zjtD2p",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "be8ff424-904b-452c-cb8e-50f840dbb1be"
      },
      "source": [
        "l = [\"organize\", \"organizes\", \"organizing\"]\n",
        "[wnl.lemmatize(x) for x in l], [porter.stem(x) for x in l]"
      ],
      "execution_count": 19,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(['organize', 'organizes', 'organizing'], ['organ', 'organ', 'organ'])"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 19
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "RYbhnvKitLoE",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "9ff2282b-3e47-443b-d7d6-84805c075826"
      },
      "source": [
        "l = [\"universe\", \"university\"]\n",
        "[wnl.lemmatize(x) for x in l], [porter.stem(x) for x in l]"
      ],
      "execution_count": 20,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(['universe', 'university'], ['univers', 'univers'])"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 20
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "C5Tf66AhomBi",
        "colab_type": "text"
      },
      "source": [
        "fastai/course-nlp"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "mxAzt_UxomBj",
        "colab_type": "text"
      },
      "source": [
        "Stemming and lemmatization are language dependent.  Languages with more complex morphologies may show bigger benefits.  For example, Sanskrit has a very [large number of verb forms](https://en.wikipedia.org/wiki/Sanskrit_verbs). "
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "HwFiWcZXomBk",
        "colab_type": "text"
      },
      "source": [
        "### Spacy"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Y1M3DEJNomBl",
        "colab_type": "text"
      },
      "source": [
        "Stemming and lemmatization are implementation dependent."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "x7mP_qJVomBm",
        "colab_type": "text"
      },
      "source": [
        "Spacy is a very modern & fast nlp library. Spacy is opinionated, in that it typically offers one highly optimized way to do something (whereas nltk offers a huge variety of ways, although they are usually not as optimized).\n",
        "\n",
        "You will need to install it.\n",
        "\n",
        "if you use conda:\n",
        "```\n",
        "conda install -c conda-forge spacy\n",
        "```\n",
        "if you use pip:\n",
        "```\n",
        "pip install -U spacy\n",
        "```\n",
        "\n",
        "You will then need to download the English model:\n",
        "```\n",
        "spacy -m download en_core_web_sm\n",
        "```"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "0xpbc3Z3th4W",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 379
        },
        "outputId": "99576a69-2e13-4fd4-808a-b00574870f0b"
      },
      "source": [
        "!pip install -U spacy\n",
        "!python -m spacy download en_core_web_sm"
      ],
      "execution_count": 24,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "Requirement already up-to-date: spacy in /usr/local/lib/python3.6/dist-packages (2.1.6)\n",
            "Requirement already satisfied, skipping upgrade: plac<1.0.0,>=0.9.6 in /usr/local/lib/python3.6/dist-packages (from spacy) (0.9.6)\n",
            "Requirement already satisfied, skipping upgrade: srsly<1.1.0,>=0.0.6 in /usr/local/lib/python3.6/dist-packages (from spacy) (0.0.7)\n",
            "Requirement already satisfied, skipping upgrade: numpy>=1.15.0 in /usr/local/lib/python3.6/dist-packages (from spacy) (1.16.4)\n",
            "Requirement already satisfied, skipping upgrade: blis<0.3.0,>=0.2.2 in /usr/local/lib/python3.6/dist-packages (from spacy) (0.2.4)\n",
            "Requirement already satisfied, skipping upgrade: preshed<2.1.0,>=2.0.1 in /usr/local/lib/python3.6/dist-packages (from spacy) (2.0.1)\n",
            "Requirement already satisfied, skipping upgrade: wasabi<1.1.0,>=0.2.0 in /usr/local/lib/python3.6/dist-packages (from spacy) (0.2.2)\n",
            "Requirement already satisfied, skipping upgrade: murmurhash<1.1.0,>=0.28.0 in /usr/local/lib/python3.6/dist-packages (from spacy) (1.0.2)\n",
            "Requirement already satisfied, skipping upgrade: cymem<2.1.0,>=2.0.2 in /usr/local/lib/python3.6/dist-packages (from spacy) (2.0.2)\n",
            "Requirement already satisfied, skipping upgrade: requests<3.0.0,>=2.13.0 in /usr/local/lib/python3.6/dist-packages (from spacy) (2.21.0)\n",
            "Requirement already satisfied, skipping upgrade: thinc<7.1.0,>=7.0.8 in /usr/local/lib/python3.6/dist-packages (from spacy) (7.0.8)\n",
            "Requirement already satisfied, skipping upgrade: chardet<3.1.0,>=3.0.2 in /usr/local/lib/python3.6/dist-packages (from requests<3.0.0,>=2.13.0->spacy) (3.0.4)\n",
            "Requirement already satisfied, skipping upgrade: urllib3<1.25,>=1.21.1 in /usr/local/lib/python3.6/dist-packages (from requests<3.0.0,>=2.13.0->spacy) (1.24.3)\n",
            "Requirement already satisfied, skipping upgrade: idna<2.9,>=2.5 in /usr/local/lib/python3.6/dist-packages (from requests<3.0.0,>=2.13.0->spacy) (2.8)\n",
            "Requirement already satisfied, skipping upgrade: certifi>=2017.4.17 in /usr/local/lib/python3.6/dist-packages (from requests<3.0.0,>=2.13.0->spacy) (2019.6.16)\n",
            "Requirement already satisfied, skipping upgrade: tqdm<5.0.0,>=4.10.0 in /usr/local/lib/python3.6/dist-packages (from thinc<7.1.0,>=7.0.8->spacy) (4.28.1)\n",
            "Requirement already satisfied: en_core_web_sm==2.1.0 from https://github.com/explosion/spacy-models/releases/download/en_core_web_sm-2.1.0/en_core_web_sm-2.1.0.tar.gz#egg=en_core_web_sm==2.1.0 in /usr/local/lib/python3.6/dist-packages (2.1.0)\n",
            "\u001b[38;5;2m✔ Download and installation successful\u001b[0m\n",
            "You can now load the model via spacy.load('en_core_web_sm')\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "VKnCL9ohomBm",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "import spacy"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "_eJrCQEPomBp",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "from spacy.lemmatizer import Lemmatizer\n",
        "lemmatizer = Lemmatizer()"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "R2Kx2CoVomBt",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "a2e63970-7152-43c4-ffae-9d65a6462948"
      },
      "source": [
        "[lemmatizer.lookup(word) for word in word_list]"
      ],
      "execution_count": 27,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['feet', 'foot', 'foots', 'footing']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 27
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "MoCO8hlWomBw",
        "colab_type": "text"
      },
      "source": [
        "Spacy doesn't offer a stemmer (since lemmatization is considered better-- this is an example of being opinionated!)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "uG464snYomBy",
        "colab_type": "text"
      },
      "source": [
        "Stop words vary from library to library"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "4buzzhjbomBz",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "nlp = spacy.load(\"en_core_web_sm\")"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "FWOhjTf3omB2",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 377
        },
        "outputId": "3f5b0d68-7d92-4168-93fc-33ac6269132b"
      },
      "source": [
        "sorted(list(nlp.Defaults.stop_words))[:20]"
      ],
      "execution_count": 29,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "[\"'d\",\n",
              " \"'ll\",\n",
              " \"'m\",\n",
              " \"'re\",\n",
              " \"'s\",\n",
              " \"'ve\",\n",
              " 'a',\n",
              " 'about',\n",
              " 'above',\n",
              " 'across',\n",
              " 'after',\n",
              " 'afterwards',\n",
              " 'again',\n",
              " 'against',\n",
              " 'all',\n",
              " 'almost',\n",
              " 'alone',\n",
              " 'along',\n",
              " 'already',\n",
              " 'also']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 29
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "ReoiGJByomB9",
        "colab_type": "text"
      },
      "source": [
        "#### Exercise: What stop words appear in spacy but not in sklearn?"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "PVlIeR0OomB_",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 647
        },
        "outputId": "81fcd69b-60ad-4dbe-9c5c-077208f5916a"
      },
      "source": [
        "set(nlp.Defaults.stop_words) - set(stop_words.ENGLISH_STOP_WORDS)"
      ],
      "execution_count": 34,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "{\"'d\",\n",
              " \"'ll\",\n",
              " \"'m\",\n",
              " \"'re\",\n",
              " \"'s\",\n",
              " \"'ve\",\n",
              " 'ca',\n",
              " 'did',\n",
              " 'does',\n",
              " 'doing',\n",
              " 'just',\n",
              " 'make',\n",
              " \"n't\",\n",
              " 'n‘t',\n",
              " 'n’t',\n",
              " 'quite',\n",
              " 'really',\n",
              " 'regarding',\n",
              " 'say',\n",
              " 'unless',\n",
              " 'used',\n",
              " 'using',\n",
              " 'various',\n",
              " '‘d',\n",
              " '‘ll',\n",
              " '‘m',\n",
              " '‘re',\n",
              " '‘s',\n",
              " '‘ve',\n",
              " '’d',\n",
              " '’ll',\n",
              " '’m',\n",
              " '’re',\n",
              " '’s',\n",
              " '’ve'}"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 34
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "heading_collapsed": true,
        "id": "4X0vYyIFomCB",
        "colab_type": "text"
      },
      "source": [
        "#### Exercise: And what stop words are in sklearn but not spacy?"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "hidden": true,
        "id": "OBQmhecZomCC",
        "colab_type": "code",
        "colab": {},
        "outputId": "4c31c44e-3386-4928-b5c3-896510fa632e"
      },
      "source": [
        "#Exercise:\n"
      ],
      "execution_count": 0,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "frozenset({'amoungst',\n",
              "           'bill',\n",
              "           'cant',\n",
              "           'co',\n",
              "           'con',\n",
              "           'couldnt',\n",
              "           'cry',\n",
              "           'de',\n",
              "           'describe',\n",
              "           'detail',\n",
              "           'eg',\n",
              "           'etc',\n",
              "           'fill',\n",
              "           'find',\n",
              "           'fire',\n",
              "           'found',\n",
              "           'hasnt',\n",
              "           'ie',\n",
              "           'inc',\n",
              "           'interest',\n",
              "           'ltd',\n",
              "           'mill',\n",
              "           'sincere',\n",
              "           'system',\n",
              "           'thick',\n",
              "           'thin',\n",
              "           'un'})"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 28
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "heading_collapsed": true,
        "id": "-NOxKSodomCF",
        "colab_type": "text"
      },
      "source": [
        "### When to use these?"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "hidden": true,
        "id": "5FOx3vr3omCF",
        "colab_type": "text"
      },
      "source": [
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/skomoroch.png?raw=1\" alt=\"\" style=\"width: 65%\"/>"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "hidden": true,
        "id": "O_GXpzs7omCG",
        "colab_type": "text"
      },
      "source": [
        "These were long considered standard techniques, but they can often **hurt** your performance **if using deep learning**. Stemming, lemmatization, and removing stop words all involve throwing away information.\n",
        "\n",
        "However, they can still be useful when working with simpler models."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "heading_collapsed": true,
        "id": "lTF0dE4SomCH",
        "colab_type": "text"
      },
      "source": [
        "### Another approach: sub-word units"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "hidden": true,
        "id": "Ea9Aa1WiomCH",
        "colab_type": "text"
      },
      "source": [
        "[SentencePiece](https://github.com/google/sentencepiece) library from Google"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "YOzOxys5omCI",
        "colab_type": "text"
      },
      "source": [
        "## Data Processing"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "IqE5PPjNomCJ",
        "colab_type": "text"
      },
      "source": [
        "Next, scikit learn has a method that will extract all the word counts for us.  In the next lesson, we'll learn how to write our own version of CountVectorizer, to see what's happening underneath the hood."
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "SZQyuSXpomCJ",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "from sklearn.feature_extraction.text import CountVectorizer, TfidfVectorizer"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "mAZNBcQVomCM",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "import nltk\n",
        "# nltk.download('punkt')"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "pcA5NhsLomCP",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "# from nltk import word_tokenize\n",
        "\n",
        "# class LemmaTokenizer(object):\n",
        "#     def __init__(self):\n",
        "#         self.wnl = stem.WordNetLemmatizer()\n",
        "#     def __call__(self, doc):\n",
        "#         return [self.wnl.lemmatize(t) for t in word_tokenize(doc)]"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "06b5ZYNUomCR",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "vectorizer = CountVectorizer(stop_words='english') #, tokenizer=LemmaTokenizer())"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "-0XsLt2qomCT",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "8b1d62f2-af3e-47dc-fe3e-fcd42d89449f"
      },
      "source": [
        "vectors = vectorizer.fit_transform(newsgroups_train.data).todense() # (documents, vocab)\n",
        "vectors.shape #, vectors.nnz / vectors.shape[0], row_means.shape"
      ],
      "execution_count": 8,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(2034, 26576)"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 8
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "scrolled": true,
        "id": "M0fbE17eomCX",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "d516e983-f3a2-4a2f-8837-f53cf392b900"
      },
      "source": [
        "print(len(newsgroups_train.data), vectors.shape)"
      ],
      "execution_count": 9,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "2034 (2034, 26576)\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "IrjSfPzLomCa",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "vocab = np.array(vectorizer.get_feature_names())"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "z7YVSTXPomCb",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "af8a1e87-104a-4c98-9cf1-7c89ab00f6b2"
      },
      "source": [
        "vocab.shape"
      ],
      "execution_count": 11,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(26576,)"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 11
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "LOo4cJFRomCe",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 89
        },
        "outputId": "f9296d07-c1c6-450e-d65a-a5c90987afb5"
      },
      "source": [
        "vocab[7000:7020]"
      ],
      "execution_count": 42,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "array(['cosmonauts', 'cosmos', 'cosponsored', 'cost', 'costa', 'costar',\n",
              "       'costing', 'costly', 'costruction', 'costs', 'cosy', 'cote',\n",
              "       'couched', 'couldn', 'council', 'councils', 'counsel',\n",
              "       'counselees', 'counselor', 'count'], dtype='<U80')"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 42
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "F08gY_TsomCg",
        "colab_type": "text"
      },
      "source": [
        "## Singular Value Decomposition (SVD)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "ahre28oComCh",
        "colab_type": "text"
      },
      "source": [
        "\"SVD is not nearly as famous as it should be.\" - Gilbert Strang"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "2MfIpgmjomCh",
        "colab_type": "text"
      },
      "source": [
        "We would clearly expect that the words that appear most frequently in one topic would appear less frequently in the other - otherwise that word wouldn't make a good choice to separate out the two topics. Therefore, we expect the topics to be **orthogonal**.\n",
        "\n",
        "The SVD algorithm factorizes a matrix into one matrix with **orthogonal columns** and one with **orthogonal rows** (along with a diagonal matrix, which contains the **relative importance** of each factor).\n",
        "\n",
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/svd_fb.png?raw=1\" alt=\"\" style=\"width: 80%\"/>\n",
        "(source: [Facebook Research: Fast Randomized SVD](https://research.fb.com/fast-randomized-svd/))\n",
        "\n",
        "SVD is an **exact decomposition**, since the matrices it creates are big enough to fully cover the original matrix. SVD is extremely widely used in linear algebra, and specifically in data science, including:\n",
        "\n",
        "- semantic analysis\n",
        "- collaborative filtering/recommendations ([winning entry for Netflix Prize](https://datajobs.com/data-science-repo/Recommender-Systems-%5BNetflix%5D.pdf))\n",
        "- calculate Moore-Penrose pseudoinverse\n",
        "- data compression\n",
        "- principal component analysis"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "lbgjQGIvomCi",
        "colab_type": "text"
      },
      "source": [
        "Latent Semantic Analysis (LSA) uses SVD.  You will sometimes hear topic modelling referred to as LSA."
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "okh4rx1WomCk",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 53
        },
        "outputId": "bca638b0-55c1-4503-9803-bde2677871f1"
      },
      "source": [
        "%time U, s, Vh = linalg.svd(vectors, full_matrices=False)"
      ],
      "execution_count": 12,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "CPU times: user 1min 32s, sys: 5.39 s, total: 1min 38s\n",
            "Wall time: 50.5 s\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "xTmWBdHIomCm",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "b4ef0108-10c0-4ad3-c22d-8f375e473bdf"
      },
      "source": [
        "print(U.shape, s.shape, Vh.shape)"
      ],
      "execution_count": 44,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "(2034, 2034) (2034,) (2034, 26576)\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Jf7rbzXKomCo",
        "colab_type": "text"
      },
      "source": [
        "Confirm this is a decomposition of the input."
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "uuLgimNPomCp",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "977fa5bc-ecc0-4109-f275-69c0ccfc98c9"
      },
      "source": [
        "s[:4]"
      ],
      "execution_count": 45,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "array([433.92698542, 291.51012741, 240.71137677, 220.00048043])"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 45
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "I0OFj8R_omCr",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "c141ed56-e1c1-47aa-da25-70e25cd92eed"
      },
      "source": [
        "np.diag(np.diag(s[:4]))"
      ],
      "execution_count": 46,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "array([433.92698542, 291.51012741, 240.71137677, 220.00048043])"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 46
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "NbQ_9naFomCu",
        "colab_type": "text"
      },
      "source": [
        "#### Answer"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "q5iQ0v8Tyc-R",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "9dede038-f872-4bf4-f357-551f9115a3a9"
      },
      "source": [
        "np.allclose(vectors, U.dot(np.diag(s)).dot(Vh))"
      ],
      "execution_count": 64,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "True"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 64
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "-TgnvRjzomC0",
        "colab_type": "text"
      },
      "source": [
        "Confirm that U, V are orthonormal"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "heading_collapsed": true,
        "id": "rukmgwXaomC1",
        "colab_type": "text"
      },
      "source": [
        "#### Answer"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "hidden": true,
        "id": "CfjEVXatomC1",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "12216bd1-0684-4e2a-e59c-5f7d82e74578"
      },
      "source": [
        "np.allclose(np.eye(U.shape[0]), U.dot(U.T))"
      ],
      "execution_count": 66,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "True"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 66
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "k-BEdRCCzRhR",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "# Memory error here:\n",
        "\n",
        "# np.allclose(np.eye(Vh.shape[0]), Vh.T.dot(Vh))"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "heading_collapsed": true,
        "id": "Ok_EJ1hXomC4",
        "colab_type": "text"
      },
      "source": [
        "#### Topics"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "hidden": true,
        "id": "RNELd4vMomC4",
        "colab_type": "text"
      },
      "source": [
        "What can we say about the singular values s?"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "hidden": true,
        "id": "YxehRHajomC5",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 269
        },
        "outputId": "96b707f7-fbbd-4657-c953-cb00edf122e3"
      },
      "source": [
        "plt.plot(s);"
      ],
      "execution_count": 19,
      "outputs": [
        {
          "output_type": "display_data",
          "data": {
            "image/png": "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\nOFnWE+4n60TElfuREUU2s/5se0RsRhyeM7LZdUXapelBb2Yx8BfArwKHgMfNbLe7v9Ds15L6oshY\n3pcM5yyVctmZLlfvBDzsBEpMFX3eDqKyM5mu2nnMtNdYNm8HE+6PjRWZKjlTxVJ4jM97TDuZkewA\n5u0kIuKI83YiM+tYsoOJI5t5bPXy6p3LeTudGjuaOLxmbLPTOKJqPlm3er04YqYtrnru8x4z08a8\nturnrH6u6uecma88x7w27SCboRUJ8AFgv7u/AmBm3wB2AAr6i0AUGX1RTF+hsw4tdXeKZadUdqZL\n5TBN7hfLZYql+csr7aWyM112iqG9XPVcyXqz85X75Zn2MqUylMrl5L47pfBaM89TCu3nPbZc8/mn\niuXZx4baZh9bplxm3mMrtZTDenk7l19cY2cyd0cR1diJVnaU1Z+q4jlt1Z/WCrHRU5nGyafCQpx8\nqivE5y+vtPfEUfI9WF+Bwb7ku6/B0LlavaynY77zakXQbwQOVt0/BPxCC15HpGFmFoaBuOh/3+Ce\nhH2pKvxLnuwQZueZ2SmVZnYQszuc8nlt6c81s3ze8899TWbaSuU5y8NzVL9+7ZqT5ylV7ehmdnZh\nx1gsl5kozj5vZQdfDMOOxXIynS6VZ9Zf7HDkhpX9DDbwafrfXLOV33jvWxb1Go1q25exZnYLcAvA\nW9/61naVIXLRMTNiS3rKks2rPm1VdgDT4dPedKk8833X2ckSY5NFzk2VOHluiqcPnaLcwA9SL+R7\nuEa1IugPA5ur7m8Kbedx9zuBOyH5ZWwL6hARuWAWhnsKOf402IqfZD4ObDWzy8ysF7gR2N2C1xER\nkQY0vUfv7kUz+yzwfZLDK+929+eb/ToiItKYlozRu/v9wP2teG4REVkYnU1LRKTLKehFRLqcgl5E\npMsp6EVEupyCXkSky3XEpQTNbBQ4sMiHrwPeaGI5zdKJdXViTdCZdammxnViXZ1YEzS/rre5+3DW\nSh0R9BfCzEYauWbiUuvEujqxJujMulRT4zqxrk6sCdpXl4ZuRES6nIJeRKTLdUPQ39nuAlJ0Yl2d\nWBN0Zl2qqXGdWFcn1gRtqiv3Y/QiIlJfN/ToRUSkjlwHvZldZ2Y/MbP9ZnbrEr7uZjN7yMxeMLPn\nzexzof1PzeywmT0VbtdXPeaPQ50/MbNfa2Ftr5rZs+H1R0LbGjN7wMz2henq0G5mdnuo6xkzu7oF\n9byrans8ZWZnzOzz7dhWZna3mR0zs+eq2ha8bcxsZ1h/n5ntbEFN/83MXgyv+10zWxXat5jZeNU2\n+8uqx7wvvO/7Q92LvqpISk0Lfr+a/f8zpa5vVtX0qpk9FdqXalulZUFb/67mcfdc3khOgfwycDnQ\nCzwNXLFEr70BuDrMDwEvAVcAfwr82xrrXxHq6wMuC3XHLartVWDdnLb/Ctwa5m8Fbgvz1wN/Dxiw\nHXh0Cd6z14G3tWNbAR8GrgaeW+y2AdYAr4Tp6jC/usk1XQsUwvxtVTVtqV5vzvM8Fuq0UPdHm1zT\ngt6vVvz/rFXXnOX/A/iTJd5WaVnQ1r+rubc89+hnLkLu7lNA5SLkLefuR9z9iTD/JrCX5Fq5aXYA\n33D3SXf/KbCfpP6lsgPYFeZ3ATdUtd/jiUeAVWa2oYV1XAO87O71fhzXsm3l7g8DJ2q83kK2za8B\nD7j7CXc/CTwAXNfMmtz9B+5eDHcfIblKW6pQ1wp3f8ST1Lin6t/RlJrqSHu/mv7/s15doVf+SeBv\n6j1HC7ZVWha09e9qrjwHfa2LkNcL25Ywsy3AVcCjoemz4SPZ3ZWPayxtrQ78wMz2WHJdXoD17n4k\nzL8OrG9DXZBcbaz6P2K7txUsfNssdX3/kqQHWHGZmT1pZv/XzD5UVeuhJahpIe/XUm+nDwFH3X1f\nVduSbqs5WdBRf1d5Dvq2M7NB4DvA5939DHAH8HbgSuAIyUfJpfZBd78a+CjwGTP7cPXC0ItZ8kOt\nLLms5MeBvw1NnbCtztOubZPGzL4EFIF7Q9MR4K3ufhXwBeCvzWzFEpXTce/XHL/L+Z2IJd1WNbJg\nRif8XeU56Bu6CHmrmFkPyRt7r7v/HYC7H3X3kruXgf/N7JDDktXq7ofD9Bjw3VDD0cqQTJgeW+q6\nSHY8T7j70VBf27dVsNBtsyT1mdnvA78O/F4ICsLwyPEwv4dkDPyd4fWrh3eaXtMi3q8lex/NrAD8\nFvDNqnqXbFvVygI67O8qz0HftouQh/HAu4C97v6Vqvbq8e3fBCpHB+wGbjSzPjO7DNhK8oVQs+ta\nbmZDlXmSL/WeC69f+RZ/J3BfVV03hSMBtgOnqz5uNtt5Pa52b6sqC9023weuNbPVYfji2tDWNGZ2\nHfBF4OPuPlbVPmxmcZi/nGTbvBLqOmNm28Pf5k1V/45m1bTQ92sp/3/+U+BFd58ZklmqbZWWBXTa\n31WzvtVtx43kG+yXSPbWX1rC1/0gyUexZ4Cnwu164OvAs6F9N7Ch6jFfCnX+hAv4lj+jrstJjm54\nGni+sk2AtcCDwD7g/wBrQrsBfxHqehbY1qK6lgPHgZVVbUu+rUh2NEeAaZIx0JsXs21Ixs33h9un\nWlDTfpLx2srf1l+GdX87vK9PAU8Av1H1PNtIwvdl4M8JP4ZsYk0Lfr+a/f+zVl2h/WvAH8xZd6m2\nVVoWtPXvau5Nv4wVEelyeR66ERGRBijoRUS6nIJeRKTLKehFRLqcgl5EpMsp6EVEupyCXkSkyyno\nRUS63P8HR2FZS5VVyFYAAAAASUVORK5CYII=\n",
            "text/plain": [
              "<Figure size 432x288 with 1 Axes>"
            ]
          },
          "metadata": {
            "tags": []
          }
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "hidden": true,
        "id": "dwW7DAs-omC7",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 288
        },
        "outputId": "11dc0081-2d58-4fde-b7e4-adf285ca100f"
      },
      "source": [
        "plt.plot(s[:10])"
      ],
      "execution_count": 20,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "[<matplotlib.lines.Line2D at 0x7f7b94f132b0>]"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 20
        },
        {
          "output_type": "display_data",
          "data": {
            "image/png": "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\nSUVORK5CYII=\n",
            "text/plain": [
              "<Figure size 432x288 with 1 Axes>"
            ]
          },
          "metadata": {
            "tags": []
          }
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "hidden": true,
        "id": "1wPNLAXMomC-",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "num_top_words=8\n",
        "\n",
        "def show_topics(a):\n",
        "    top_words = lambda t: [vocab[i] for i in np.argsort(t)[:-num_top_words-1:-1]]\n",
        "    topic_words = ([top_words(t) for t in a])\n",
        "    return [' '.join(t) for t in topic_words]"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "hidden": true,
        "id": "70opPe03omDB",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 197
        },
        "outputId": "3c887c7b-f51d-456e-fd13-3e0ba7a66e04"
      },
      "source": [
        "show_topics(Vh[:10])"
      ],
      "execution_count": 22,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['ditto critus propagandist surname galacticentric kindergarten surreal imaginative',\n",
              " 'jpeg gif file color quality image jfif format',\n",
              " 'graphics edu pub mail 128 3d ray ftp',\n",
              " 'jesus god matthew people atheists atheism does graphics',\n",
              " 'image data processing analysis software available tools display',\n",
              " 'god atheists atheism religious believe religion argument true',\n",
              " 'space nasa lunar mars probe moon missions probes',\n",
              " 'image probe surface lunar mars probes moon orbit',\n",
              " 'argument fallacy conclusion example true ad argumentum premises',\n",
              " 'space larson image theory universe physical nasa material']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 22
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "hidden": true,
        "id": "wcYhXDhvomDG",
        "colab_type": "text"
      },
      "source": [
        "We get topics that match the kinds of clusters we would expect! This is despite the fact that this is an **unsupervised algorithm** - which is to say, we never actually told the algorithm how our documents are grouped."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "hidden": true,
        "id": "xS8V0xIuomDG",
        "colab_type": "text"
      },
      "source": [
        "We will return to SVD in **much more detail** later.  For now, the important takeaway is that we have a tool that allows us to exactly factor a matrix into orthogonal columns and orthogonal rows."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "HO7gFH2DomDH",
        "colab_type": "text"
      },
      "source": [
        "## Non-negative Matrix Factorization (NMF)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "mXRdeNfMomDI",
        "colab_type": "text"
      },
      "source": [
        "#### Motivation"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "P_dvK8rEomDI",
        "colab_type": "text"
      },
      "source": [
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/face_pca.png?raw=1\" alt=\"PCA on faces\" style=\"width: 80%\"/>\n",
        "\n",
        "(source: [NMF Tutorial](http://perso.telecom-paristech.fr/~essid/teach/NMF_tutorial_ICME-2014.pdf))\n",
        "\n",
        "A more interpretable approach:\n",
        "\n",
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/face_outputs.png?raw=1\" alt=\"NMF on Faces\" style=\"width: 80%\"/>\n",
        "\n",
        "(source: [NMF Tutorial](http://perso.telecom-paristech.fr/~essid/teach/NMF_tutorial_ICME-2014.pdf))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "dvL3kRfHomDJ",
        "colab_type": "text"
      },
      "source": [
        "#### Idea"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "hFN1NWg0omDJ",
        "colab_type": "text"
      },
      "source": [
        "Rather than constraining our factors to be *orthogonal*, another idea would to constrain them to be *non-negative*. NMF is a factorization of a non-negative data set $V$: $$ V = W H$$ into non-negative matrices $W,\\; H$. Often positive factors will be **more easily interpretable** (and this is the reason behind NMF's popularity). \n",
        "\n",
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/face_nmf.png?raw=1\" alt=\"NMF on faces\" style=\"width: 80%\"/>\n",
        "\n",
        "(source: [NMF Tutorial](http://perso.telecom-paristech.fr/~essid/teach/NMF_tutorial_ICME-2014.pdf))\n",
        "\n",
        "Nonnegative matrix factorization (NMF) is a non-exact factorization that factors into one skinny positive matrix and one short positive matrix.  NMF is NP-hard and non-unique.  There are a number of variations on it, created by adding different constraints. "
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "ktxXkYBxomDK",
        "colab_type": "text"
      },
      "source": [
        "#### Applications of NMF"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "xyusKy7MomDK",
        "colab_type": "text"
      },
      "source": [
        "- [Face Decompositions](http://scikit-learn.org/stable/auto_examples/decomposition/plot_faces_decomposition.html#sphx-glr-auto-examples-decomposition-plot-faces-decomposition-py)\n",
        "- [Collaborative Filtering, eg movie recommendations](http://www.quuxlabs.com/blog/2010/09/matrix-factorization-a-simple-tutorial-and-implementation-in-python/)\n",
        "- [Audio source separation](https://pdfs.semanticscholar.org/cc88/0b24791349df39c5d9b8c352911a0417df34.pdf)\n",
        "- [Chemistry](http://ieeexplore.ieee.org/document/1532909/)\n",
        "- [Bioinformatics](https://bmcbioinformatics.biomedcentral.com/articles/10.1186/s12859-015-0485-4) and [Gene Expression](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2623306/)\n",
        "- Topic Modeling (our problem!)\n",
        "\n",
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/nmf_doc.png?raw=1\" alt=\"NMF on documents\" style=\"width: 80%\"/>\n",
        "\n",
        "(source: [NMF Tutorial](http://perso.telecom-paristech.fr/~essid/teach/NMF_tutorial_ICME-2014.pdf))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "H6trh-PmomDL",
        "colab_type": "text"
      },
      "source": [
        "**More Reading**:\n",
        "\n",
        "- [The Why and How of Nonnegative Matrix Factorization](https://arxiv.org/pdf/1401.5226.pdf)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "4a9LIxT-omDL",
        "colab_type": "text"
      },
      "source": [
        "### NMF from sklearn"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "tmonwT3QomDL",
        "colab_type": "text"
      },
      "source": [
        "We will use [scikit-learn's implementation of NMF](http://scikit-learn.org/stable/modules/generated/sklearn.decomposition.NMF.html):"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "BtnOzND_omDN",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "m,n=vectors.shape\n",
        "d=5  # num topics"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "LciAMjOuomDO",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "clf = decomposition.NMF(n_components=d, random_state=1)\n",
        "\n",
        "W1 = clf.fit_transform(vectors)\n",
        "H1 = clf.components_"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "X4lJO3IZomDR",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 107
        },
        "outputId": "2a01f75d-b391-4da5-af9b-1d4bab095171"
      },
      "source": [
        "show_topics(H1)"
      ],
      "execution_count": 25,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['jpeg image gif file color images format quality',\n",
              " 'edu graphics pub mail 128 ray ftp send',\n",
              " 'space launch satellite nasa commercial satellites year market',\n",
              " 'jesus god people matthew atheists does atheism said',\n",
              " 'image data available software processing ftp edu analysis']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 25
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Cs-aKM7QomDU",
        "colab_type": "text"
      },
      "source": [
        "\n",
        "### TF-IDF"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "WF9Oy909omDU",
        "colab_type": "text"
      },
      "source": [
        "[Topic Frequency-Inverse Document Frequency](http://www.tfidf.com/) (TF-IDF) is a way to normalize term counts by taking into account how often they appear in a document, how long the document is, and how commmon/rare the term is.\n",
        "\n",
        "TF = (# occurrences of term t in document) / (# of words in documents)\n",
        "\n",
        "IDF = log(# of documents / # documents with term t in it)"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "xswbqgfcomDU",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "vectorizer_tfidf = TfidfVectorizer(stop_words='english')\n",
        "vectors_tfidf = vectorizer_tfidf.fit_transform(newsgroups_train.data) # (documents, vocab)"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "lWbc4BplEZIw",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "7fe86a5b-ba84-4ba6-a0c0-532474f1e6ba"
      },
      "source": [
        "vectors_tfidf.shape"
      ],
      "execution_count": 28,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(2034, 26576)"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 28
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "KLthze1WomDV",
        "colab_type": "code",
        "colab": {},
        "outputId": "cc5163ec-449e-440d-ef5d-33a9a87c4cc3"
      },
      "source": [
        "newsgroups_train.data[10:20]"
      ],
      "execution_count": 0,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "[\"a\\n\\nWhat about positional uncertainties in S-L 1993e?   I assume we know where\\nand what Galileo is doing within a few meters.   But without the\\nHGA,  don't we have to have some pretty good ideas, of where to look\\nbefore imaging?  If the HGA was working,  they could slew around\\nin near real time (Less speed of light delay).  But when they were\\nimaging toutatis????  didn't someone have to get lucky on a guess to\\nfind the first images?   \\n\\nAlso, I imagine S-L 1993e will be mostly a visual image.  so how will\\nthat affect the other imaging missions.  with the LGA,  there is a real\\ntight allocation of bandwidth.   It may be premature to hope for answers,\\nbut I thought i'd throw it on the floor.\",\n",
              " \"I would like to program Tseng ET4000 to nonstandard 1024x768 mode by\\nswitching to standard 1024x768 mode using BIOS and than changing some\\ntiming details (0x3D4 registers 0x00-0x1F) but I don't know how to\\nselect 36 MHz pixel clock I need. The BIOS function selects 40 MHz.\\n\\nIs there anybody who knows where to obtain technical info about this.\\nI am also interested in any other technical information about Tseng ET4000\\nand Trident 8900 and 9000 chipsets.\\n\\n\\t\\t\\tthanks very much\",\n",
              " 'In-Reply-To: <20APR199312262902@rigel.tamu.edu> lmp8913@rigel.tamu.edu (PRESTON, LISA M)',\n",
              " \"\\n\\n\\n\\nI'm not sure, but it almost sounds like they can't figure out where the \\n_nucleus_ is within the coma. If they're off by a couple hundred\\nmiles, well, you can imagine the rest...\\n\",\n",
              " \"Hello,\\n     I am looking to add voice input capability to a user interface I am\\ndeveloping on an HP730 (UNIX) workstation.  I would greatly appreciate \\ninformation anyone would care to offer about voice input systems that are \\neasily accessible from the UNIX environment. \\n\\n     The names or adresses of applicable vendors, as well as any \\nexperiences you have had with specific systems, would be very helpful.\\n\\n     Please respond via email; I will post a summary if there is \\nsufficient interest.\\n\\n\\nThanks,\\nKen\\n\\n\\nP.S.  I have found several impressive systems for IBM PC's, but I would \\nlike to avoid the hassle of purchasing and maintaining a separate PC if \\nat all possible.\\n\\n-------------------------------------------------------------------------------\\nKen Hinckley (kph2q@virginia.edu)\\nUniversity of Virginia \\nNeurosurgical Visualization Laboratory\",\n",
              " '\\nIt was a test of the first reusable tool.\\n\\n\\nPointy so they can find them or so they will stick into their pants better, and\\nbe closer to their brains?',\n",
              " '\\nSize of armies, duration, numbers of casualties both absolute and as a\\npercentage of those involved, geographical area and numbers of countries\\ntoo, are all measures of size.  In this case I\\'d say the relevant\\nstatistic would be the number of combatants (total troops) compared to\\ntotal casualties from among the total civilian population in the\\naffected geographical area.\\n\\n\\nVietnam and Korea might make good comparisons.\\n\\n\\nWestern news in general, but in particular the American \"mass media\":\\nCBS, NBC, ABC, etc.  The general tone of the news during the whole\\nwar was one of \"those poor, poor Iraqis\" along with \"look how precisely\\nthis cruise missile blew this building to bits\".\\n\\n\\nI agree.\\n\\n\\nPerhaps so.  And maybe the atomic bomb was a mistake too.  But that\\'s easy\\nto say from our \"enlightened\" viewpoint here in the 90\\'s, right?  Back\\nthen, it was *all-out* war, and Germany and Japan had to be squashed.\\nAfter all, a million or more British had already died, hundreds of \\nthousands of French, a couple hundread thousand or so Americans, and \\nmillions of Russians, not to mention a few million Jews, Poles, and \\nother people of slavic descent in German concentration camps.  All \\nthings considered, the fire-bombings and the atomic bomb were\\nessential (and therefore justified) in bringing the war to a quick\\nend to avoid even greater allied losses.\\n\\nI, for one, don\\'t regret it.\\n\\n\\nSure.  And it\\'s the people who suffer because of them.  All the more\\nreason to depose these \"entrenched political rulers operating in their\\nown selfish interests\"!  Or do you mean that this applies to the allies\\nas well??\\n\\n\\nI make no claim or effort to justify the misguided foreign policy of the\\nWest before the war.  It is evident that the West, especially America,\\nmisjudged Hussein drastically.  But once Hussein invaded Kuwait and \\nthreatened to militarily corner a significant portion of the world\\'s\\noil supply, he had to be stopped.  Sure the war could have been\\nprevented by judicious and concerted effort on the part of the West\\nbefore Hussein invaded Kuwait, but it is still *Hussein* who is\\nresponsible for his decision to invade.  And once he did so, a\\nstrong response from the West was required.\\n\\n\\nWell, it\\'s not very \"loving\" to allow a Hussein or a Hitler to gobble up\\nnearby countries and keep them.  Or to allow them to continue with mass\\nslaughter of certain peoples under their dominion.  So, I\\'d have to\\nsay yes, stopping Hussein was the most \"loving\" thing to do for the\\nmost people involved once he set his mind on military conquest.\\n\\nI mentioned it.\\n\\nIf we hadn\\'t intervened, allowing Hussein to keep Kuwait, then it would\\nhave been appeasement.  It is precisely the lessons the world learned\\nin WW2 that motivated the Western alliance to war.  Letting Hitler take\\nAustria and Czechoslavkia did not stop WW2 from happening, and letting\\nHussein keep Kuwait would not have stopped an eventual Gulf War to\\nprotect Saudi Arabia.\\n\\n\\nSure.  What was truly unfortunate was that they followed Hitler in\\nhis grandiose quest for a \"Thousand Year Reich\".  The consequences\\nstemmed from that.\\n\\nWhat should I say about them?  Anything in particular?\\n\\n\\n\\nSo?  It was the *policemen* on trial not Rodney King!!  And under American\\nlaw they deserved a jury of *their* peers!  If there had been black\\nofficers involved, I\\'m sure their would have been black jurors too.\\nThis point (of allegedly racial motivations) is really shallow.\\n\\n\\nSo?  It\\'s \"hard to imagine\"?  So when has Argument from Incredulity\\ngained acceptance from the revered author of \"Constructing a Logical\\nArgument\"?  Can we expect another revision soon??  :)  (Just kidding.)\\n\\n\\nI have to admit that I wonder this too.  But *neither* the prosecution\\nnor the defense is talking.  So one cannot conclude either way due to\\nthe silence of the principals.  \\n\\n\\nOK.  It certainly seemed to me that there was excessive force involved.\\nAnd frankly, the original \"not guilty\" verdict baffled me too.  But then\\nI learned that the prosecution in the first case did not try to convict\\non a charge of excessive force or simple assault which they probably\\nwould have won, they tried to get a conviction on a charge of aggravated\\nassault with intent to inflict serious bodily harm.  A charge, which\\nnews commentators said, was akin to attempted murder under California\\nlaw.  Based on what the prosecution was asking for, it\\'s evident that \\nthe first jury decided that the officers were \"not guilty\".  Note, \\nnot \"not guilty\" of doing wrong, but \"not guilty\" of aggravated assault \\nwith the *intent* of inflicting serious bodily harm.  The seeds of the \\nprosecutions defeat were in their own overconfidence in obtaining a \\nverdict such that they went for the most extreme charge they could.\\n\\nIf the facts as the news commentators presented them are true, then\\nI feel the \"not guilty\" verdict was a reasonable one.\\n\\n\\nThanks mathew, I like the quote.  Pretty funny actually.  (I\\'m a \\nMonty Python fan, you know.  Kind of seems in that vein.)\\n\\nOf course, oversimplifying any moral argument can make it seem\\ncontradictory.  But then, you know that already.  \\n\\nRegards,',\n",
              " \"<stuff deleted>\\n\\nYou mean like: seconds, minutes, hours, days, months, years. . .  :-)\\n\\nRemember,  the Fahrenheit temperature scale is also a centigrade scale.  Some\\nrevisionists tell the history something like this:  The coldest point in a\\nparticular Russian winter was marked on the thermometer as was the body\\ntemperature of a volunteer (turns out he was sick, but you can't win 'em all).\\nThen the space in between the marks on the thermometer was then divided into\\nhundredths.\\n\\t\\t\\t\\t\\t\\t\\t\\t:-)\\n\\nFWIW,\\n\\nDoug Page\\n\",\n",
              " \"\\nIt wasn't especially prominent, as I recall.  However, quite possibly it's\\nno longer on display; NASM, like most museums, has much more stuff than it\\ncan display at once, and does rotate the displays occasionally.\",\n",
              " \"DM> Fact or rumor....?  Madalyn Murray O'Hare an atheist who eliminated the\\nDM> use of the bible reading and prayer in public schools 15 years ago is now\\nDM> going to appear before the FCC with a petition to stop the reading of the\\nDM> Gospel on the airways of America.  And she is also campaigning to remove\\nDM> Christmas programs, songs, etc from the public schools.  If it is true\\nDM> then mail to Federal Communications Commission 1919 H Street Washington DC\\nDM> 20054 expressing your opposition to her request.  Reference Petition number\\n\\nDM> 2493.\\n\\nFalse.  This story has been going around for years.  There's not a drop of\\ntruth.  Note that I don't care for O'Hare (O'Hair?) myself, but this\\nis one thing she's not guilty of.\\n\"]"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 160
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "W3qIHlfqomDY",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "W1 = clf.fit_transform(vectors_tfidf)\n",
        "H1 = clf.components_"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "yhXsIO5ZomDZ",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 107
        },
        "outputId": "007313d4-7b7c-4fd5-a0bd-421d1ea7f332"
      },
      "source": [
        "show_topics(H1)"
      ],
      "execution_count": 31,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "['people don think just like objective say morality',\n",
              " 'graphics thanks files image file program windows know',\n",
              " 'space nasa launch shuttle orbit moon lunar earth',\n",
              " 'ico bobbe tek beauchaine bronx manhattan sank queens',\n",
              " 'god jesus bible believe christian atheism does belief']"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 31
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "bhURk49QomDb",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 287
        },
        "outputId": "800a35e3-7edb-43a4-94ba-313b3470586a"
      },
      "source": [
        "plt.plot(clf.components_[0])"
      ],
      "execution_count": 32,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "[<matplotlib.lines.Line2D at 0x7f7b921b40f0>]"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 32
        },
        {
          "output_type": "display_data",
          "data": {
            "image/png": "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\n",
            "text/plain": [
              "<Figure size 432x288 with 1 Axes>"
            ]
          },
          "metadata": {
            "tags": []
          }
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "t0C3AIpWomDe",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 35
        },
        "outputId": "029ba0ca-ab7a-4126-abdd-600f2ce4230e"
      },
      "source": [
        "clf.reconstruction_err_"
      ],
      "execution_count": 33,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "43.712926057952785"
            ]
          },
          "metadata": {
            "tags": []
          },
          "execution_count": 33
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "W_Lp2jhqomDh",
        "colab_type": "text"
      },
      "source": [
        "### NMF in summary"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "vEIrSRTlomDi",
        "colab_type": "text"
      },
      "source": [
        "Benefits: Fast and easy to use!\n",
        "\n",
        "Downsides: took years of research and expertise to create"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "mbAaC259omDi",
        "colab_type": "text"
      },
      "source": [
        "Notes:\n",
        "- For NMF, matrix needs to be at least as tall as it is wide, or we get an error with fit_transform\n",
        "- Can use df_min in CountVectorizer to only look at words that were in at least k of the split texts"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "7kYUL_PRomDj",
        "colab_type": "text"
      },
      "source": [
        "## Truncated SVD"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "vq2onVZzomDj",
        "colab_type": "text"
      },
      "source": [
        "We saved a lot of time when we calculated NMF by only calculating the subset of columns we were interested in. Is there a way to get this benefit with SVD? Yes there is! It's called truncated SVD.  We are just interested in the vectors corresponding to the **largest** singular values."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Ov21nHCTomDk",
        "colab_type": "text"
      },
      "source": [
        "<img src=\"https://github.com/javiber/course-nlp/blob/master/images/svd_fb.png?raw=1\" alt=\"\" style=\"width: 80%\"/>\n",
        "\n",
        "(source: [Facebook Research: Fast Randomized SVD](https://research.fb.com/fast-randomized-svd/))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "EBXhKfhmomDl",
        "colab_type": "text"
      },
      "source": [
        "#### Shortcomings of classical algorithms for decomposition:"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "bZqnIjukomDl",
        "colab_type": "text"
      },
      "source": [
        "- Matrices are \"stupendously big\"\n",
        "- Data are often **missing or inaccurate**.  Why spend extra computational resources when imprecision of input limits precision of the output?\n",
        "- **Data transfer** now plays a major role in time of algorithms.  Techniques the require fewer passes over the data may be substantially faster, even if they require more flops (flops = floating point operations).\n",
        "- Important to take advantage of **GPUs**.\n",
        "\n",
        "(source: [Halko](https://arxiv.org/abs/0909.4061))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "QsgwDUUIomDl",
        "colab_type": "text"
      },
      "source": [
        "#### Advantages of randomized algorithms:"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "IvPIg02xomDm",
        "colab_type": "text"
      },
      "source": [
        "- inherently stable\n",
        "- performance guarantees do not depend on subtle spectral properties\n",
        "- needed matrix-vector products can be done in parallel\n",
        "\n",
        "(source: [Halko](https://arxiv.org/abs/0909.4061))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "aWNeOluXomDm",
        "colab_type": "text"
      },
      "source": [
        "### Timing comparison"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "PkN8KyVgomDn",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 53
        },
        "outputId": "05e995eb-62a1-467a-d652-7e2b8f240238"
      },
      "source": [
        "%time u, s, v = np.linalg.svd(vectors, full_matrices=False)"
      ],
      "execution_count": 34,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "CPU times: user 1min 36s, sys: 4.85 s, total: 1min 41s\n",
            "Wall time: 52.3 s\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "UAkrVanbFiCT",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 161
        },
        "outputId": "2b5634cb-0d10-48ce-fb01-255e28a477a7"
      },
      "source": [
        "!pip install fbpca"
      ],
      "execution_count": 36,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "Collecting fbpca\n",
            "  Downloading https://files.pythonhosted.org/packages/a7/a5/2085d0645a4bb4f0b606251b0b7466c61326e4a471d445c1c3761a2d07bc/fbpca-1.0.tar.gz\n",
            "Building wheels for collected packages: fbpca\n",
            "  Building wheel for fbpca (setup.py) ... \u001b[?25l\u001b[?25hdone\n",
            "  Stored in directory: /root/.cache/pip/wheels/53/a2/dd/9b66cf53dbc58cec1e613d216689e5fa946d3e7805c30f60dc\n",
            "Successfully built fbpca\n",
            "Installing collected packages: fbpca\n",
            "Successfully installed fbpca-1.0\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "rKD5vpG7omDp",
        "colab_type": "code",
        "colab": {}
      },
      "source": [
        "from sklearn import decomposition\n",
        "import fbpca"
      ],
      "execution_count": 0,
      "outputs": []
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "-tLQ3ch_omDr",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 53
        },
        "outputId": "11f41895-60ed-4ca9-9258-8a8798e7ba27"
      },
      "source": [
        "%time u, s, v = decomposition.randomized_svd(vectors, 10)"
      ],
      "execution_count": 38,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "CPU times: user 9.3 s, sys: 1.78 s, total: 11.1 s\n",
            "Wall time: 5.93 s\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "ekY2RE9YomDt",
        "colab_type": "text"
      },
      "source": [
        "Randomized SVD from Facebook's library fbpca:"
      ]
    },
    {
      "cell_type": "code",
      "metadata": {
        "id": "qCoZnVoUomDt",
        "colab_type": "code",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 53
        },
        "outputId": "68c912e5-7e4a-445e-e9c8-df4c1d3e49a9"
      },
      "source": [
        "%time u, s, v = fbpca.pca(vectors, 10)"
      ],
      "execution_count": 39,
      "outputs": [
        {
          "output_type": "stream",
          "text": [
            "CPU times: user 2.92 s, sys: 673 ms, total: 3.59 s\n",
            "Wall time: 1.96 s\n"
          ],
          "name": "stdout"
        }
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "a49sLJh5omDw",
        "colab_type": "text"
      },
      "source": [
        "For more on randomized SVD, check out my [PyBay 2017 talk](https://www.youtube.com/watch?v=7i6kBz1kZ-A&list=PLtmWHNX-gukLQlMvtRJ19s7-8MrnRV6h6&index=7).\n",
        "\n",
        "For significantly more on randomized SVD, check out the [Computational Linear Algebra course](https://github.com/fastai/numerical-linear-algebra)."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "MS6EAaM9omDx",
        "colab_type": "text"
      },
      "source": [
        "## End"
      ]
    }
  ]
}