nltk-session-2-updated-Python3.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<br>\n",
    "<img style=\"float:left\" src=\"http://ipython.org/_static/IPy_header.png\" />\n",
    "<br>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Session 2: Working with a corpus of Malcolm Fraser's speeches"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "from __future__ import print_function, division\n",
    "\n",
    "import sys\n",
    "import nltk\n",
    "from IPython.display import display, clear_output\n",
    "sys.path.append(\"/usr/lib/python2.7/site-packages/\")\n",
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Welcome back!**\n",
    "\n",
    "So, what did we learn yesterday? A brief recap:\n",
    "\n",
    "* The **IPython** Notebook\n",
    "* **Python**: syntax, variables, functions, etc.\n",
    "\n",
    "Today's focus will be on **developing more advanced NLTK skills** and using these skills to **investigate the Fraser Speeches Corpus**. In the final session, we will discuss **how to use what you have learned here in your own research**.\n",
    "\n",
    "*Any questions or anything before we dive in?*"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Malcolm Fraser and his speeches"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "So, for much of the next two sessions, we are going to be working with a corpus of speeches made by Malcolm Fraser. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "# this code allows us to display images and webpages in our notebook\n",
    "from IPython.display import display\n",
    "from IPython.display import display_pretty, display_html, display_jpeg, display_png, display_svg\n",
    "from IPython.display import Image\n",
    "from IPython.display import HTML\n",
    "import nltk"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<img src=\"http://www.unimelb.edu.au/malcolmfraser/photographs/family/105~36fam6p9.jpg\"/>"
      ],
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "Image(url='http://www.unimelb.edu.au/malcolmfraser/photographs/family/105~36fam6p9.jpg')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Because our project here is *corpus driven*, we don't necessarily need to know about Malcolm Fraser and his speeches in order to analyse the data: we may be happy to let things emerge from the data themselves. Even so, it's nice to know a bit about him.\n",
    "\n",
    "Malcolm Fraser was a member of Australian parliament between 1955 and 1983, holding the seat of Wannon in western Victoria. He held a number of ministries, including Education and Science, and Defence. \n",
    "\n",
    "He became leader of the Liberal Party in March 1975 and Prime Minister of Australia in December 1975, following the dismissal of the Whitlam government in November 1975.\n",
    "\n",
    "He retired from parliament following the defeat of the Liberal party at the 1983 election and in 2009 resigned from the Liberal party after becoming increasingly critical of some of its policies. He died on 20 March, 2015."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<iframe src=http://en.wikipedia.org/wiki/Malcolm_Fraser width=700 height=350></iframe>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "HTML('<iframe src=http://en.wikipedia.org/wiki/Malcolm_Fraser width=700 height=350></iframe>')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In 2004, Malcolm Fraser made the University of Melbourne the official custodian of his personal papers. The collection consists of a large number of photographs, speeches and personal papers, including Neville Fraser's WWI diaries and materials relating to CARE Australia, which Mr Fraser helped to found in 1987. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<iframe src=http://www.unimelb.edu.au/malcolmfraser/ width=700 height=350></iframe>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "HTML('<iframe src=http://www.unimelb.edu.au/malcolmfraser/ width=700 height=350></iframe>')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Between 1954 until 1983, Malcolm Fraser regularly made a talk to his electorate that was broadcast on Sunday evening on local radio.  \n",
    "\n",
    "The speeches were transcribed years ago. Optical Character Recognition (OCR) was used to digitise the transcripts. This means that the texts are not of perfect quality. \n",
    "\n",
    "Some have been manually corrected, which has removed extraneous characters and mangled words, but even so there are still some quirks in the formatting. \n",
    "\n",
    "For much of this session, we are going to manipulate the corpus data, and use the data to restructure the corpus. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Cleaning the corpus"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "A common part of corpus building is corpus cleaning. Reasons for cleaning include:\n",
    "\n",
    "1. Not break the code with unexpected input\n",
    "2. Ensure that searches match as many examples as possible\n",
    "3. Increasing readability, the accuracy of taggers, stemmers, parsers, etc.\n",
    "\n",
    "The level of kind of cleaning depends on your data and the aims of your project. In the case of very clean data (lucky you!), there may be little that needs to be done. With messy data, you may need to go as far as to correct variant spellings (online conversation, very old books)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Discussion"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*What are the characteristics of clean and messy data? Any personal experiences? Discuss with your neighbours.* \n",
    "\n",
    "It will be important to bear these characteristics in mind once you start building your own datasets and corpora. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Exploring the corpus"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "First of all, let's load in our text.\n",
    "\n",
    "Via file management, open and inspect one file in *corpora/UMA_Fraser_Radio_Talks*. What do you see? Are there any potential problems?\n",
    "\n",
    "We can also look at file contents within the IPython Notebook itself:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "import os"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "# import tokenizers\n",
    "from nltk import word_tokenize\n",
    "from nltk.text import Text"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['UDS2013680-1-full.txt', 'UDS2013680-10-full.txt', 'UDS2013680-100-full.txt']\n"
     ]
    }
   ],
   "source": [
    "# make a list of files in the directory 'UMA_Fraser_Radio_Talks'\n",
    "files = os.listdir('../UMA_Fraser_Radio_Talks')\n",
    "print(files[:3])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Actually, since we'll be referring to this path quite a bit, let's make it into a variable. This makes our code easier to use on other projects (and saves typing)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "corpus_path = '../UMA_Fraser_Radio_Talks'"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can now tell Python to get the contents of a file in the file list and print it:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<!--start metadata-->\r\n",
      "Title: Ministry of Defence, Vietnam\r\n",
      "Description: Radio talk\r\n",
      "Date: 12/11/1969\r\n",
      "Collection: John Malcolm Fraser, 2007.0023\r\n",
      "Collection URI: http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details\r\n",
      "Format: Uncorrected OCR text\r\n",
      "<!--end metadata-->\r\n",
      "\r\n",
      "\r\n",
      "\r\n",
      "                        I am looking forward to my new task as Minister for Defence, although\r\n",
      "                        it is with regret that I relinquish my post as Minister for Education \r\n",
      "                        and Science.\r\n",
      "                        I was associated with my old portfolio at a time when great changes \r\n",
      "                        were taking place in education.\r\n",
      "                        These changes were occurring at a time of unprecedented public \r\n",
      "                        interest and concern for education, at a time of increasing student \r\n",
      "                        numbers and rising aspirations.\r\n",
      "                        I was glad to have played a part in the task that continues to face \r\n",
      "                        those responsible for providing more and better education.\r\n",
      "                        I now look to the task of administering the country's defences.\r\n",
      "                        If the Government did not make sensible and proper decisions in this \r\n",
      "                        vital area of our national affairs, our future could be in jeopardy. \r\n",
      "                        I think we all recognise the need for strong and adequate defence\r\n",
      "                        forces and for proper arrangements with allies, for co-operation with \r\n",
      "                        like-minded countries.\r\n",
      "                        We are entering a new era with the British withdrawal proceeding. It \r\n",
      "                        will not be an easy portfolio to administer, with responsibilities \r\n",
      "                        spreading over three Service departments. My Department also has \r\n",
      "                        particularly close links with the Department of Supply.\r\n",
      "                        I welcome the opportunity to serve Australia in John Gorton's \r\n",
      "                        Government in this vitally important portfolio.\r\n",
      "                        The Ministry gained in vigour, experience and youth as a result of \r\n",
      "                        the changes announced by the Prime Minister during the week.\r\n",
      "                        The appointment of the seven new Ministers will mean the introduction \r\n",
      "                        of new talents into the task of running the country.\r\n",
      "                        There are five new Liberal Ministers--Mr. Andrew Peacock (Vic.), Mr. \r\n",
      "                        Don Chipp (Vic.), Mr. Tom Hughes (N.S.W.), Mr. Jim Killen (Qld.) and \r\n",
      "                        senator Bob Cotton (N.S.W.). In addition two new Country Party \r\n",
      "                        Ministers, Mr. R.N. (Mac) Holten (Vic.) and Senator Tom Drake-Brockman \r\n",
      "                        (W.A.) are promoted from the back-benches.\r\n",
      "                        Mr. Peacock becomes the Minister for the Army and Minister Assisting \r\n",
      "                        the Prime Minister.\r\n",
      "                        Although only 30, he has already demonstrated his ability in the House \r\n",
      "                        and in a wide range of matters.\r\n",
      "                        Mr. Hughes, Q.C., a Sydney barrister, becomes Attorney-General, a post \r\n",
      "                        for which he has outstanding qualifications.\r\n",
      "                        Mr. Chipp brings with him experience as a former Minister for the Navy \r\n",
      "                        in his new post as Minister for Customs and Excise.\r\n",
      "                        Mr. Jim Killen, a Brisbane solicitor, is an asset to the Government \r\n",
      "                        as new Minister for the Navy.\r\n",
      "                        Senator Cotton, Government Whip in the Senate and who has held\r\n",
      "                        important posts in that Chamber, has had wide experience in a range\r\n",
      "                        of matters including rural industries. He becomes Minister for\r\n",
      "                        Civil Aviation.\r\n",
      "                        Senator Drake-Brockman, formerly Chairman of Committees in the\r\n",
      "                        Senate, is Minister for Air, and Mr. Holten, the able member for\r\n",
      "                        Indi, is Minister for Repatriation.\r\n",
      "                        A number of other portfolios changed hands in this major re-construction\r\n",
      "                        and strengthening of the Ministry.\r\n",
      "                                                \r\n",
      "                                                ends.\r\n",
      "\n"
     ]
    }
   ],
   "source": [
    "# print(file contents)# change zero to something else to print(a different file)# \"r\" tells python that it has the ability to read the files\n",
    "files = open(os.path.join(corpus_path, files[0]), \"r\")\n",
    "text = files.read()\n",
    "print(text)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Exploring further: splitting up text"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We've had a look at one file, but the real strength of NLTK is to be able to explore large bodies of text. \n",
    "\n",
    "When we manually inspected the first file, we saw that it contained a metadata section, before the body of the text. \n",
    "\n",
    "We can ask Python to show us just the start of the file. For analysing the text, it is useful to split the metadata section off, so that we can interrogate it separately but also so that it won't distort our results when we analyse the text."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "# split the file we read in above into two parts\n",
    "data = text.split(\"<!--end metadata-->\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<!--start metadata-->\r\n",
      "Title: Ministry of Defence, Vietnam\r\n",
      "Description: Radio talk\r\n",
      "Date: 12/11/1969\r\n",
      "Collection: John Malcolm Fraser, 2007.0023\r\n",
      "Collection URI: http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details\r\n",
      "Format: Uncorrected OCR text\r\n",
      "\n"
     ]
    }
   ],
   "source": [
    "# view the first part\n",
    "print(data[0])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "* <!--start metadata-->\n",
      "* Title: Ministry of Defence, Vietnam\n",
      "* Description: Radio talk\n",
      "* Date: 12/11/1969\n",
      "* Collection: John Malcolm Fraser, 2007.0023\n",
      "* Collection URI: http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details\n",
      "* Format: Uncorrected OCR text\n",
      "* \n"
     ]
    }
   ],
   "source": [
    "# split into lines, add '*' to the start of each line\n",
    "# \\r is a carriage return, like on a typewriter.\n",
    "# \\n is a newline character\n",
    "for line in data[0].split('\\r\\n'):\n",
    "    print('*', line)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "* Title: Ministry of Defence, Vietnam\n",
      "* Description: Radio talk\n",
      "* Date: 12/11/1969\n",
      "* Collection: John Malcolm Fraser, 2007.0023\n",
      "* Collection URI: http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details\n",
      "* Format: Uncorrected OCR text\n"
     ]
    }
   ],
   "source": [
    "# skip empty lines and any line that starts with '<'\n",
    "for line in data[0].split('\\r\\n'):\n",
    "    if not line:\n",
    "        continue\n",
    "    if line[0] == '<':\n",
    "        continue\n",
    "    print('*', line)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "* ['Title', ' Ministry of Defence, Vietnam']\n",
      "* ['Description', ' Radio talk']\n",
      "* ['Date', ' 12/11/1969']\n",
      "* ['Collection', ' John Malcolm Fraser, 2007.0023']\n",
      "* ['Collection URI', ' http', '//gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details']\n",
      "* ['Format', ' Uncorrected OCR text']\n"
     ]
    }
   ],
   "source": [
    "# split the metadata items on ':' so that we can interrogate each one\n",
    "for line in data[0].split('\\r\\n'):\n",
    "    if not line:\n",
    "        continue\n",
    "    if line[0] == '<':\n",
    "        continue\n",
    "    element = line.split(':')\n",
    "    print('*', element)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "* ['Title', ' Ministry of Defence, Vietnam']\n",
      "* ['Description', ' Radio talk']\n",
      "* ['Date', ' 12/11/1969']\n",
      "* ['Collection', ' John Malcolm Fraser, 2007.0023']\n",
      "* ['Collection URI', ' http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details']\n",
      "* ['Format', ' Uncorrected OCR text']\n"
     ]
    }
   ],
   "source": [
    "# actually, only split on the first colon\n",
    "for line in data[0].split('\\r\\n'):\n",
    "    if not line:\n",
    "        continue\n",
    "    if line[0] == '<':\n",
    "        continue\n",
    "    element = line.split(':', 1)\n",
    "    print('*', element)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### **Challenge**: Building a Dictionary"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We've already worked with strings and lists. Another kind of data structure in Python is a *dictionary*.\n",
    "\n",
    "Here is how a simple dictionary works:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "3809"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# create a dictionary\n",
    "commonwords = {'the': 4023, 'of': 3809, 'a': 3098}\n",
    "# search the dictionary for 'of'\n",
    "commonwords['of']"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "dict"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "type(commonwords)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The point of dictionaries is to store a *key* (the word) and a *value* (the count). When you ask for the key, you get its value.\n",
    "\n",
    "Notice that you use curly braces for dictionaries, but square brackets for lists.\n",
    "\n",
    "Dictionaries are a great way to work with the metadata in our corpus. Let's build a dictionary called *metadata*:\n",
    "\n",
    "Your first line will look like this:\n",
    "\n",
    "      metadata = {}"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'Collection URI': ' http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details', 'Description': ' Radio talk', 'Format': ' Uncorrected OCR text', 'Title': ' Ministry of Defence, Vietnam', 'Collection': ' John Malcolm Fraser, 2007.0023', 'Date': ' 12/11/1969'}\n"
     ]
    }
   ],
   "source": [
    "metadata = {}\n",
    "for line in data[0].split('\\r\\n'):\n",
    "    if not line:\n",
    "        continue\n",
    "    if line[0] == '<':\n",
    "        continue\n",
    "    element = line.split(':', 1)\n",
    "    metadata[element[0]] = element[-1]\n",
    "print(metadata)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      " 12/11/1969\n"
     ]
    }
   ],
   "source": [
    "# look up the date\n",
    "print(metadata['Date'])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Building functions"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Challenge**: define a function that creates a dictionary of the metadata for each file and gets rid of the whitespace at the start of each element\n",
    "\n",
    "**Hint**: to get rid of the whitespace use the *.strip()* command."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "# open the first file, read it and then split it into two parts, metadata and body\n",
    "data = open(os.path.join(corpus_path, 'UDS2013680-100-full.txt'))\n",
    "data = data.read().split(\"<!--end metadata-->\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "def parse_metadata(text):\n",
    "    metadata = {}\n",
    "    for line in text.split('\\r\\n'):\n",
    "        if not line:\n",
    "            continue\n",
    "        if line[0] == '<':\n",
    "            continue\n",
    "        element = line.split(':', 1)\n",
    "        metadata[element[0]] = element[-1].strip(' ')\n",
    "    return metadata"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Test it out!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'Collection': 'John Malcolm Fraser, 2007.0023',\n",
       " 'Collection URI': 'http://gallery.its.unimelb.edu.au/imu/imu.php?request=load&irn=115190&ecatalogue=on&view=details',\n",
       " 'Date': '2/04/1963',\n",
       " 'Description': 'press statement',\n",
       " 'Format': 'Uncorrected OCR text',\n",
       " 'Title': 'Portland wool sales'}"
      ]
     },
     "execution_count": 23,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "parse_metadata(data[0])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now that we're confident that the function works, let's find out a bit about the corpus.\n",
    "As a start, it would be useful to know which years the texts are from. Are they evenly distributed over time? A graph will tell us!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "#import conditional frequency distribution\n",
    "from nltk.probability import ConditionalFreqDist\n",
    "import matplotlib\n",
    "% matplotlib inline"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x1081e4190>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "cfdist = ConditionalFreqDist()\n",
    "for filename in os.listdir(corpus_path):\n",
    "    text = open(os.path.join(corpus_path, filename)).read()\n",
    "    #split text of file on 'end metadata'\n",
    "    text = text.split(\"<!--end metadata-->\")\n",
    "    #parse metadata using previously defined function \"parse_metadata\"\n",
    "    metadata = parse_metadata(text[0])\n",
    "    #skip all speeches for which there is no exact date\n",
    "    if metadata['Date'][0] == 'c':\n",
    "        continue\n",
    "    #build a frequency distribution graph by year, that is, take the final bit of the 'Date' string after '/'\n",
    "    cfdist['count'][metadata['Date'].split('/')[-1]] += 1\n",
    "cfdist.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now let's build another graph, but this time by the 'Description' field:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x103d9b390>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "cfdist2 = ConditionalFreqDist()\n",
    "for filename in os.listdir(corpus_path):\n",
    "    text = open(os.path.join(corpus_path, filename)).read()\n",
    "    text = text.split(\"<!--end metadata-->\")\n",
    "    metadata = parse_metadata(text[0])\n",
    "    if metadata['Date'][0] == 'c':\n",
    "        continue\n",
    "    cfdist2['count'][metadata['Description']] += 1\n",
    "cfdist2.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Discussion"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We've got messy data! What's the lesson here?\n",
    "<br>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Bonus challenge**: Build a frequency distribution graph that includes speeches without an exact date.\n",
    "Hint: you'll need to tell Python to ignore the 'c' and just take the digits"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x108381290>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "cfdist3 = ConditionalFreqDist()\n",
    "for filename in os.listdir(corpus_path):\n",
    "    text = open(os.path.join(corpus_path, filename)).read()\n",
    "    text = text.split(\"<!--end metadata-->\")\n",
    "    metadata = parse_metadata(text[0])\n",
    "    date = metadata['Date']\n",
    "    if date[0] == 'c':\n",
    "        year = date[1:]\n",
    "    elif date[0] != 'c':\n",
    "        year = date.split('/')[-1]\n",
    "    cfdist3['count'][year] += 1\n",
    "cfdist3.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Ordering our data"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Previously, we looked at features of language in whole books. The way in which you organise your data will affect the ways in which you can interrogate it. Because our data samples span a long stretch of time, we thought we'd investigate the ways in which Malcolm Fraser's language changes over time. This will be the key focus of the next session.\n",
    "\n",
    "In order to study this, it is helpful to structure our data according to the year of the sample. This simply means creating folders for each sample year, and moving the text of each speech into the correct one.\n",
    "\n",
    "We can use our metadata parser to help with this task. Then, after structuring our corpus by date, we want the metadata gone, so that when we count language features in the files, we are not also counting the metadata.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Side note - Regular expressions\n",
    "Regular expressions are a powerful means of searching for patterns in data. In this case, we're going to construct a regular expression to find the year of each speech. There are various ways in which we could write this expression, depending on how confident we are that the data is clean and the range of dates we're interested in."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "ename": "OSError",
     "evalue": "[Errno 17] File exists: '../corpora/fraser-year'",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mOSError\u001b[0m                                   Traceback (most recent call last)",
      "\u001b[0;32m<ipython-input-28-e6873f0bce81>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m()\u001b[0m\n\u001b[1;32m      3\u001b[0m \u001b[0;31m# a path to our soonwordso-be organised corpus\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      4\u001b[0m \u001b[0mnewpath\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m'../corpora/fraser-year'\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 5\u001b[0;31m \u001b[0mos\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mmakedirs\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mnewpath\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m      6\u001b[0m \u001b[0mfiles\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mos\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mlistdir\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mcorpus_path\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      7\u001b[0m \u001b[0;31m# define a regex to match year portion of date\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/Users/fionatweedie/anaconda/lib/python2.7/os.pyc\u001b[0m in \u001b[0;36mmakedirs\u001b[0;34m(name, mode)\u001b[0m\n\u001b[1;32m    155\u001b[0m         \u001b[0;32mif\u001b[0m \u001b[0mtail\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0mcurdir\u001b[0m\u001b[0;34m:\u001b[0m           \u001b[0;31m# xxx/newdir/. exists if xxx/newdir exists\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    156\u001b[0m             \u001b[0;32mreturn\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 157\u001b[0;31m     \u001b[0mmkdir\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mname\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mmode\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    158\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    159\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mremovedirs\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mname\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;31mOSError\u001b[0m: [Errno 17] File exists: '../corpora/fraser-year'"
     ]
    }
   ],
   "source": [
    "import re\n",
    "import os\n",
    "# a path to our soonwordso-be organised corpus\n",
    "newpath = '../corpora/fraser-year'\n",
    "os.makedirs(newpath)\n",
    "files = os.listdir(corpus_path)\n",
    "# define a regex to match year portion of date\n",
    "yearfinder = re.compile('19[0-9]{2}')\n",
    "for filename in files:\n",
    "    # split file contents at end of metadata\n",
    "    text = open(os.path.join(corpus_path, filename))\n",
    "    data = text.read().split(\"<!--end metadata-->\")\n",
    "    # get date from data[0]\n",
    "    # use our metadata parser to get metadata\n",
    "    metadata = parse_metadata(data[0])\n",
    "    #look up date field of dict entry\n",
    "    date = metadata.get('Date')\n",
    "    # search date for year\n",
    "    yearmatch = re.search(yearfinder, str(date))\n",
    "    #get the year as a string\n",
    "    year = str(yearmatch.group())\n",
    "    # make a directory with the year name\n",
    "    if not os.path.exists(os.path.join(newpath, year)):\n",
    "        os.makedirs(os.path.join(newpath, year))\n",
    "    # make a new file with the same name as the old one in the new dir\n",
    "    fo = open(os.path.join(newpath, year, filename),\"w\")\n",
    "    # write the content portion, without metadata\n",
    "    fo.write(data[1])\n",
    "    fo.close()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Did it work? How can we check?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['1954', '1956', '1957', '1958', '1959', '1960', '1961', '1962', '1963', '1964', '1965', '1966', '1967', '1968', '1969', '1970', '1971', '1972', '1973', '1974', '1975', '1981', '1982']\n",
      "['UDS2013680-703-full.txt', 'UDS2013680-704-full.txt', 'UDS2013680-705-full.txt', 'UDS2013680-706-full.txt', 'UDS2013680-707-full.txt', 'UDS2013680-708-full.txt', 'UDS2013680-709-full.txt', 'UDS2013680-710-full.txt', 'UDS2013680-711-full.txt', 'UDS2013680-712-full.txt', 'UDS2013680-713-full.txt', 'UDS2013680-714-full.txt', 'UDS2013680-715-full.txt', 'UDS2013680-716-full.txt', 'UDS2013680-717-full.txt', 'UDS2013680-718-full.txt', 'UDS2013680-719-full.txt', 'UDS2013680-720-full.txt', 'UDS2013680-721-full.txt', 'UDS2013680-722-full.txt', 'UDS2013680-723-full.txt', 'UDS2013680-724-full.txt', 'UDS2013680-725-full.txt']\n"
     ]
    }
   ],
   "source": [
    "print(os.listdir(newpath))\n",
    "print(os.listdir(newpath + '/1981'))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Using NLTK to analyse the Fraser Corpus"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The books were were working with yesterday had already had some processing done on them so that we could use NLTK to find features of the language. Remember that Python regards a text file as a single long string of characters. The first thing to do is to start breaking the text up into sentences and words."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['ELECTORAL', 'RADIO', 'TALK', 'Embargo', ':', 'Sunday', ',', '23rd', 'Feb.', '75', '.', '6.00', 'p.m', '.', 'THE', 'HON', '.', 'MEMBER', 'FOR', 'WANNON', '-', 'MALCOLM', 'FRASER', 'In', 'answer', 'to', 'questions', 'early', 'this', 'week', ',', 'the', 'Treasurer', ',', 'Dr', 'Cairns', ',', 'put', 'himself', 'in', 'direct', 'contradiction', 'to', 'the', 'Prime', 'Minister', 'concerning', 'the', 'nature', 'of', 'economic', 'problems', '.', 'On', 'the', '27th', 'January', ',', 'Mr', 'Whitlam', 'was', 're-', 'ported', 'to', 'have', 'said', 'from', 'Adelaide', ':', \"''\", 'You', 'can', 'not', 'blame', 'Vietnam', 'for', 'the', 'inflation', 'in', 'the', 'Western', 'world', '.', '``', 'You', 'can', 'not', 'blame', 'the', 'Oil', 'crisis', 'for', 'the', 'inflation', 'in', 'Australia', '.', 'You', 'can', 'not']\n"
     ]
    }
   ],
   "source": [
    "from nltk import word_tokenize\n",
    "speech = open('../corpora/fraser-year/1975/UDS2013680-678-full.txt', \"r\").read() \n",
    "tokens = word_tokenize(speech)\n",
    "print(tokens[:100])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Breaking a speech into tokens lets us do the sort of word counting that we were doing yesterday on the speeches. We can do some more interesting linguistic analysis if we use Part of Speech tagging. NLTK has a number of different Part of Speech tags that we could use, but the simplest one is called 'Universal', and we'll use that here."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {
    "collapsed": false,
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[('They', u'PRON'), ('refuse', u'VERB'), ('to', u'PRT'), ('permit', u'VERB'), ('us', u'PRON'), ('the', u'DET'), ('refuse', u'NOUN'), ('permit', u'NOUN')]\n"
     ]
    }
   ],
   "source": [
    "sentence = \"They refuse to permit us the refuse permit\"\n",
    "words = word_tokenize(sentence)\n",
    "tagged = nltk.pos_tag(words, tagset='universal')\n",
    "print(tagged)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Part of Speech tagging creates bigrams, that is, it associates the word with its tag in a pair of items that we can see above in brackets.  "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(u'PRON', 2), (u'VERB', 2), (u'NOUN', 2), (u'DET', 1), (u'PRT', 1)]"
      ]
     },
     "execution_count": 32,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "tag_fd = nltk.FreqDist(tag for (word, tag) in tagged)\n",
    "tag_fd.most_common()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Challenge!\n",
    "Use Part of Speech tagging to tag the speech that we have just tokenised the do the following:\n",
    "* Find the most common parts of speech\n",
    "* Find the most common verbs and create a frequency Distribution graph of your result\n",
    "* Find the 10 most common nouns in the speech\n",
    "\n",
    "*Hint: to find the most common verbs and nouns, you will need to create a list that contains only the verbs or only the nouns from the speech. Use a for loop to create your list. Then create a frequency distribution*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(u'NOUN', 291),\n",
       " (u'VERB', 156),\n",
       " (u'ADP', 128),\n",
       " (u'DET', 127),\n",
       " (u'.', 84),\n",
       " (u'ADV', 50),\n",
       " (u'ADJ', 49),\n",
       " (u'PRON', 39),\n",
       " (u'PRT', 32),\n",
       " (u'CONJ', 26),\n",
       " (u'NUM', 22),\n",
       " (u'X', 6)]"
      ]
     },
     "execution_count": 51,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "tagged_speech = nltk.pos_tag(tokens, tagset = 'universal')\n",
    "speech_fd = nltk.FreqDist(tag for (word, tag) in tagged_speech)\n",
    "speech_fd.most_common()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 62,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "156\n",
      "[('is', 15), ('are', 10), ('have', 8), ('be', 6), ('made', 5), ('blame', 4), ('can', 4), ('has', 3), ('said', 3), ('does', 3)]\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x108b039d0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "verblist = []\n",
    "for (word, tag) in tagged_speech:\n",
    "    if tag == 'VERB':\n",
    "        verblist.append(word)\n",
    "# Check the length of the list of verbs. \n",
    "#If it matches the number of verbs above, you can be fairly sure your loop has worked as expected\n",
    "print(len(verblist))verb_fd = nltk.FreqDist(verblist)\n",
    "print(verb_fd.most_common()[:10])verb_fd.plot(cumulative = True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 59,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "291\n",
      "[('Prime', 8), ('Vietnam', 8), ('Minister', 8), ('unemployment', 7), ('wool', 7), ('government', 7), ('South', 5), ('United', 4), ('Australia', 4), ('North', 4)]\n"
     ]
    }
   ],
   "source": [
    "nounlist = []\n",
    "for (word, tag) in tagged_speech:\n",
    "    if tag == 'NOUN':\n",
    "        nounlist.append(word)\n",
    "#print(nounlist[:10])print(len(nounlist))noun_fd = nltk.FreqDist(nounlist)\n",
    "print(noun_fd.most_common()[:10])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Extension**\n",
    "There are a few things to note about this result - Prime and Minister have been returned as two different, equally frequent nouns. Because we're humans, not computers, we know it's likely that what we're actually seeing is 'Prime Minister'. It's also unlikely that 'North' 'South' occur alone - perhaps Mr Fraser was talking baout North and South Vietnam? We could test for bigrams (words that typically occur side by side) to see if this is the case. In order to perform this test, we must first convert our list of tokens into and NLTK text. We can then use specific NLTK functions on the text."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 72,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<type 'list'>\n",
      "<class 'nltk.text.Text'>\n",
      "Prime Minister; United States; South Vietnam; Third World; tax payer;\n",
      "small minority; made available; wool stocks; North Vietnam; Minister\n",
      "made\n"
     ]
    }
   ],
   "source": [
    "print(type(tokens))speech_text = nltk.Text(tokens)\n",
    "print(type(speech_text))speech_text.collocations()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Some linguistics..."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Functional linguistics* is a research area concerned with how *realised language* (lexis and grammar) work to achieve meaningful social functions.\n",
    "\n",
    "One functional linguistic theory is *Systemic Functional Linguistics*, developed by Michael Halliday (Prof. Emeritus at University of Sydney).\n",
    "\n",
    "Central to the theory is a division between **experiential meanings** and **interpersonal meanings**.\n",
    "\n",
    "* Experiential meanings communicate what happened to whom, under what circumstances.\n",
    "* Interpersonal meanings negotiate identities and role relationships between speakers \n",
    "\n",
    "Halliday argues that these two kinds of meaning are realised **simultaneously** through different parts of English grammar.\n",
    "\n",
    "* Experiential meanings are made through **transitivity choices**.\n",
    "* Interpersonal meanings are made through **mood choices**\n",
    "\n",
    "\n",
    "Transitivity choices include fitting together configurations of:\n",
    "\n",
    "* Participants (*a man, green bikes*)\n",
    "* Processes (*sleep, has always been, is considering*)\n",
    "* Circumstances (*on the weekend*, *in Australia*)\n",
    "\n",
    "Mood features of a language include:\n",
    "\n",
    "* Mood types (*declarative, interrogative, imperative*)\n",
    "* Modality (*would, can, might*)\n",
    "* Lexical density--wordshe number of words per clause, the number of content to non-content words, etc.\n",
    "\n",
    "Lexical density is usually a good indicator of the general tone of texts. The language of academia, for example, often has a huge number of nouns to verbs. We can approximate an academic tone simply by making nominally dense clauses: \n",
    "\n",
    "      The consideration of interest is the potential for a participant of a certain demographic to be in Group A or Group B*.\n",
    "\n",
    "Notice how not only are there many nouns (*consideration*, *interest*, *potential*, etc.), but that the verbs are very simple (*is*, *to be*).\n",
    "\n",
    "In comparison, informal speech is characterised by smaller clauses, and thus more verbs.\n",
    "\n",
    "      A: Did you feel like dropping by?\n",
    "      B: I thought I did, but now I don't think I want to\n",
    "\n",
    "Here, we have only a few, simple nouns (*you*, *I*), with more expressive verbs (*feel*, *dropping by*, *think*, *want*)\n",
    "\n",
    "> **Note**: SFL argues that through *grammatical metaphor*, one linguistic feature can stand in for another. *Would you please shut the door?* is an interrogative, but it functions as a command. *invitation* is a nominalisation of a process, *invite*. We don't have time to deal with these kinds of realisations, unfortunately."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In the context of Fraser's speech, there are nearly twice as many nouns as verbs, and the verbs are generally quite simple ones (parts of To Be and To Have make up about a quarter). This suggests that Fraser's speech, even when giving a radio talk to his electorate, is more towards the formal end of the spectrum. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Recap\n",
    "So far today we have:\n",
    "* Imported text into NLTK\n",
    "* Used functions and loops to investigate metadata and organise our corpus\n",
    "* Tokenised raw text into words\n",
    "* Tagged words as parts of speech\n",
    "* Converted a list into NLTK Text for further analysis"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Stopwords\n",
    "Yesterday, when we did our frequency counts of the books in the NLTK Library, we noticed that a lot of speace was taken up by little words like 'and' and 'of' and 'the' which don't add a lot to our understanding of text. These are called 'stop words'. It will help our analysis if we exclude them."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 76,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[('the', 71),\n",
       " ('.', 39),\n",
       " ('of', 29),\n",
       " ('to', 27),\n",
       " (',', 27),\n",
       " ('in', 27),\n",
       " ('and', 21),\n",
       " ('a', 18),\n",
       " ('that', 17),\n",
       " ('is', 15),\n",
       " ('are', 10),\n",
       " ('for', 10),\n",
       " ('not', 8),\n",
       " ('have', 8),\n",
       " ('Minister', 8),\n",
       " ('Prime', 8),\n",
       " ('Vietnam', 8),\n",
       " ('The', 7),\n",
       " ('wool', 7),\n",
       " ('government', 7)]"
      ]
     },
     "execution_count": 76,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fdist1 = nltk.FreqDist(tokens)\n",
    "fdist1.most_common()[:20]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 88,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "1010\n",
      "435\n"
     ]
    }
   ],
   "source": [
    "print(len(speech_text))\n",
    "print(len(set(speech_text)))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 121,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "881\n",
      "363\n"
     ]
    }
   ],
   "source": [
    "#First let's get rid of the puncutation\n",
    "speech = [word for word in speech_text if word.isalpha()]\n",
    "print(len(speech))#Then get rid of capitals\n",
    "vocab = [word.lower() for word in speech]\n",
    "print(len(set(vocab)))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 123,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[('unemployment', 8),\n",
       " ('prime', 8),\n",
       " ('minister', 8),\n",
       " ('vietnam', 8),\n",
       " ('wool', 7),\n",
       " ('government', 7),\n",
       " ('blame', 6),\n",
       " ('world', 5),\n",
       " ('south', 5),\n",
       " ('made', 5),\n",
       " ('australia', 4),\n",
       " ('question', 4),\n",
       " ('north', 4),\n",
       " ('united', 4),\n",
       " ('years', 3),\n",
       " ('wage', 3),\n",
       " ('inflation', 3),\n",
       " ('every', 3),\n",
       " ('dr', 3),\n",
       " ('people', 3)]"
      ]
     },
     "execution_count": 123,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from nltk.corpus import stopwords\n",
    "#Create a variable that contains all the stopwords in the NLTK corpus\n",
    "ignored_words = nltk.corpus.stopwords.words('english')\n",
    "unstopped = [word for word in vocab if word not in stopwords.words('english')]\n",
    "fdist2 = nltk.FreqDist(unstopped)\n",
    "fdist2.most_common()[:20]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The list we have now is probably more intersting if we wanted to get a sense of the key issues that Fraser was talking about in this speech. Note, we're working with a very small sample here, only 800 words long. This sort of analysis is much more useful over really big corpora.\n",
    "\n",
    "*Note: We could have condensed the first two steps into a single line of code that looked like this:*\n",
    "\n",
    "        unstopped = [word for word in speech if word.lower() not in stopwords.words('english') and word.isalpha()]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Collocation\n",
    "We've just used collocation to test a hypothesis about the most common nouns in the speech we were investigating. Collocation can be quite a powerful tool for finding features of language.\n",
    "\n",
    "First, let's look for bigrams in the whole list of tokens:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 126,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(',', 'and'),\n",
       " ('.', 'The'),\n",
       " ('.', '``'),\n",
       " ('Prime', 'Minister'),\n",
       " ('for', 'the'),\n",
       " ('in', 'the'),\n",
       " ('of', 'the'),\n",
       " ('on', 'the'),\n",
       " ('the', 'government'),\n",
       " ('to', 'the')]"
      ]
     },
     "execution_count": 126,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from nltk.collocations import *\n",
    "bigram_measures = nltk.collocations.BigramAssocMeasures()\n",
    "finder = BigramCollocationFinder.from_words(tokens)\n",
    "sorted(finder.nbest(bigram_measures.raw_freq, 10))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "That doesn't tell us much. Let's try again with 'unstopped' our list of tokens with the punctuation and stopwords removed"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 127,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[('around', 'world'),\n",
       " ('dr', 'cairns'),\n",
       " ('inflation', 'australia'),\n",
       " ('last', 'years'),\n",
       " ('made', 'available'),\n",
       " ('minister', 'made'),\n",
       " ('north', 'vietnam'),\n",
       " ('prime', 'minister'),\n",
       " ('south', 'vietnam'),\n",
       " ('united', 'states')]"
      ]
     },
     "execution_count": 127,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from nltk.collocations import *\n",
    "bigram_measures = nltk.collocations.BigramAssocMeasures()\n",
    "finder = BigramCollocationFinder.from_words(unstopped)\n",
    "sorted(finder.nbest(bigram_measures.raw_freq, 10))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As well as identifying collocations (words that appear near each other), we can also look for n-grams or clusters, which appear immediately adjacent to each other. Repeated N-grams are a good way to get a sense of what a text is about. First, let's see how n-grams are created:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 131,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['The', 'family', 'of', 'Dashwood', 'had', 'long', 'been', 'settled', 'in', 'Sussex', '.']\n"
     ]
    }
   ],
   "source": [
    "print(sent2)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 132,
   "metadata": {
    "collapsed": false,
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "('The', 'family', 'of')\n",
      "('family', 'of', 'Dashwood')\n",
      "('of', 'Dashwood', 'had')\n",
      "('Dashwood', 'had', 'long')\n",
      "('had', 'long', 'been')\n",
      "('long', 'been', 'settled')\n",
      "('been', 'settled', 'in')\n",
      "('settled', 'in', 'Sussex')\n",
      "('in', 'Sussex', '.')\n"
     ]
    }
   ],
   "source": [
    "from nltk.util import ngrams\n",
    "n = 3\n",
    "trigrams = ngrams(sent2, 3)\n",
    "for gram in trigrams:\n",
    "    print(gram)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There are a lot of trigrams in the sentence, and they don't tell us much. It's when n-grams are repeated that they start to get interesting."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 133,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "from collections import defaultdict\n",
    "#this will let us find duplicates in our list of n-grams"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 134,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "#Define a function that will find duplicate lists within a list (i.e. duplicate n-grams within a text)\n",
    "def list_duplicates(seq):\n",
    "    tally = defaultdict(list)\n",
    "    for i, item in enumerate(seq):\n",
    "        tally[item].append(i)\n",
    "    return ((len(locs), key) for key, locs in tally.items() if len(locs) > threshold)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 137,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "#Define a function that will find n-grams that occur atleast 4 times\n",
    "def ngrammer(text, gramsize, threshold = 4):\n",
    "    def list_duplicates(seq):\n",
    "        tally = defaultdict(list)\n",
    "        for i, item in enumerate(seq):\n",
    "            tally[item].append(i)\n",
    "        return ((len(locs), key) for key, locs in tally.items() if len(locs) > threshold)\n",
    "    raw_grams = ngrams(text, gramsize)\n",
    "    dupes = list_duplicates(raw_grams)\n",
    "    return sorted(dupes, reverse = True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 173,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(72, (u'I', u'am', u'sure')),\n",
       " (57, (u'in', u'the', u'world')),\n",
       " (53, (u'as', u'soon', u'as')),\n",
       " (45, (u'I', u'do', u'not')),\n",
       " (42, (u'could', u'not', u'be')),\n",
       " (36, (u'would', u'have', u'been')),\n",
       " (36, (u'her', u'sister', u's')),\n",
       " (34, (u'I', u'dare', u'say')),\n",
       " (33, (u'in', u'spite', u'of')),\n",
       " (31, (u'she', u'could', u'not')),\n",
       " (31, (u'Mrs', u'Jennings', u's')),\n",
       " (27, (u'it', u'would', u'be')),\n",
       " (25, (u'the', u'rest', u'of')),\n",
       " (25, (u'that', u'she', u'had')),\n",
       " (25, (u'of', u'Mrs', u'Jennings')),\n",
       " (25, (u'Mrs', u'John', u'Dashwood')),\n",
       " (24, (u'to', u'be', u'sure')),\n",
       " (24, (u'of', u'her', u'sister')),\n",
       " (24, (u'I', u'have', u'been')),\n",
       " (24, (u'Colonel', u'Brandon', u's')),\n",
       " (23, (u'would', u'not', u'be')),\n",
       " (23, (u'her', u'mother', u's')),\n",
       " (23, (u'as', u'well', u'as')),\n",
       " (23, (u'a', u'great', u'deal')),\n",
       " (22, (u'to', u'her', u'sister')),\n",
       " (22, (u'the', u'Miss', u'Steeles')),\n",
       " (22, (u'she', u'did', u'not')),\n",
       " (22, (u'rest', u'of', u'the')),\n",
       " (22, (u'out', u'of', u'the')),\n",
       " (22, (u'on', u'the', u'subject')),\n",
       " (22, (u'of', u'her', u'own')),\n",
       " (22, (u'of', u'Colonel', u'Brandon')),\n",
       " (22, (u'it', u'was', u'not')),\n",
       " (22, (u'and', u'Mrs', u'Jennings')),\n",
       " (21, (u'the', u'same', u'time')),\n",
       " (21, (u'her', u'mother', u'and')),\n",
       " (21, (u'for', u'some', u'time')),\n",
       " (21, (u'at', u'the', u'same')),\n",
       " (21, (u'am', u'sure', u'I'))]"
      ]
     },
     "execution_count": 173,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sense = [word for word in text2 if word.isalpha()]\n",
    "ngrammer(sense, 3, threshold = 20)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 148,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(4, ('the', 'Prime', 'Minister')),\n",
       " (4, ('The', 'Prime', 'Minister')),\n",
       " (3, ('the', 'United', 'States')),\n",
       " (3, ('can', 'not', 'blame')),\n",
       " (3, ('a', 'result', 'of')),\n",
       " (3, ('You', 'can', 'not')),\n",
       " (3, ('.', 'The', 'Prime'))]"
      ]
     },
     "execution_count": 148,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ngrammer(tokens, 3, threshold = 2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "###Another way to get those ngrams\n",
    "\n",
    "* No functions here, for simplicity\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "ename": "NameError",
     "evalue": "name 'tokens' is not defined",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mNameError\u001b[0m                                 Traceback (most recent call last)",
      "\u001b[0;32m<ipython-input-1-21fb47cd7905>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m()\u001b[0m\n\u001b[1;32m      4\u001b[0m \u001b[0mthreshold\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;36m2\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      5\u001b[0m \u001b[0mng\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;36m3\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 6\u001b[0;31m \u001b[0mtesttext\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtokens\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m      7\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      8\u001b[0m \u001b[0;31m#Create out ngram, convert to a list,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;31mNameError\u001b[0m: name 'tokens' is not defined"
     ]
    }
   ],
   "source": [
    "import operator\n",
    "from collections import Counter\n",
    "threshold = 2\n",
    "ng = 3\n",
    "testtext = tokens\n",
    "\n",
    "#Create out ngram, convert to a list, \n",
    "#run a counter to count the number of entries for each unique list element\n",
    "raw_grams = ngrams(testtext, ng)\n",
    "listgrams = list(raw_grams)\n",
    "counts = Counter(listgrams)\n",
    "print(len(listgrams), len(counts)))\n",
    "#Create a regular dictionary, this is mostly done so we can ignore Counter values less than threshold\n",
    "D = {}\n",
    "for k,v in counts.items():\n",
    "    if v > threshold:\n",
    "        D[k] = v\n",
    "#Here is a way to sort a dictionary, based on the value (key=operator.itemgetter(1))\n",
    "sorted_x = sorted(D.items(), key=operator.itemgetter(1), reverse=True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.4.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}