0. Python_Intro.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "# Python Introduction\n",
    "##### Created by Professor Eric Larson, contact at eclarson@smu.edu for errors or questions\n",
    "\n",
    "In this notebook, we will introduce the basics of programming in python as well as the installation of different modules and libraries. Debugging in python can be a pain, but there are many different ways of debugging depending on what you are most comfortable with. \n",
    "\n",
    "We will go over:\n",
    "+ Analysing and debugging errors \n",
    "+ Setting breakpoints with pdb \n",
    "+ Using an IDE with python that can look at memory, set breakpoints, etc.\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "subslide"
    }
   },
   "source": [
    "![Guido Von Rossum](https://raw.githubusercontent.com/eclarson/DataMiningNotebooks/master/data/guido.png)\n",
    "\n",
    "Python was founded by a guy named Guido Von Rossum in 1989. I will let him explain his motivations.\n",
    "From wikipedia:\n",
    ">Over six years ago, in December 1989, I was looking for a \"hobby\" programming project that would keep me occupied during the week around Christmas. My office ... would be closed, but I had a home computer, and not much else on my hands. I decided to write an interpreter for the new scripting language I had been thinking about lately: a descendant of ABC that would appeal to Unix/C hackers. I chose Python as a working title for the project, being in a slightly irreverent mood (and a big fan of Monty Python's Flying Circus).\n",
    "\n",
    "        -Guido van Rossum in 1996\n",
    "\n",
    "So let that be a lesson! Python is not named after the snake, it is after Monty Python. However, even though the language is a bit quirky, do not let that fool you. It is absolutely made for people to use as a serious programming language and tool. Whether you have novice programming skills or are a sesoned veteran at OOP. \n",
    "\n",
    "For example, take a look at the most popular programming languages as identified by the number of projects in GitHub, and the number of related questions on stack overflow. Notice the other langauges next to python, like java, php, c++, ruby, and all the heavy hitters. Its also on every top ten list of programming languages needed to get a job in programming. Check it out. Graphic credit given to RedMonk.\n",
    "![Python](https://raw.githubusercontent.com/eclarson/DataMiningNotebooks/master/data/python_ranking.png)\n",
    "\n",
    "Moreover, python is one of the fastest growing languages used in scientific computing and data science. According to a recent survey, the three most helpful languages or packages for doing data science are R, SAS, and python. You will likely make use of all three for a given project or set of projects. See http://www.r-bloggers.com/data-science-toolbox-survey-results-surprise-r-and-python-win/ for a high level description of the survey.\n",
    "\n",
    "# Running Python\n",
    "Python can be run in various ways. We will cover how to run it from the interpreter prompt, command line scripts, and from iPython notebook."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "# this is a comment\n",
    "\n",
    "# place this at the top of python file to enable running as >>./filename.py\n",
    "#! /usr/bin/python\n",
    "\n",
    "# otherwise you can run with >>python filename.py {or} >>python27 filename.py\n",
    "\n",
    "# those commands can be run from a terminal window"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "hello world\n"
     ]
    }
   ],
   "source": [
    "# hello world from iPython Notebook\n",
    "print(\"hello world\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Syntax\n",
    "Okay, so lets first dive into some of the syntax in python programming."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Variable type examples:\n",
      "<class 'int'>\n",
      "<class 'int'>\n",
      "<class 'float'>\n",
      "<class 'bool'>\n",
      "True\n",
      "False\n"
     ]
    }
   ],
   "source": [
    "# ============================================\n",
    "# Variables Example\n",
    "int_val = 8\n",
    "long_val = 23423423235 # this will now be an int\n",
    "float_val = 2.546923764237654239\n",
    "bool_val = False\n",
    "\n",
    "print (\"Variable type examples:\")\n",
    "print (type(int_val))\n",
    "print (type(long_val)) # longs are ints bit in python 3\n",
    "print (type(float_val))\n",
    "print (type(bool_val))\n",
    "\n",
    "# testing for the type of a variable\n",
    "temp = isinstance(float_val,float)\n",
    "print (temp)\n",
    "print (isinstance(float_val,int))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Arithmetic examples:\n",
      "2.6666666666666665\n",
      "2.6666666666666665\n",
      "2.6666666666666665\n",
      "2\n",
      "False\n",
      "False\n",
      "True\n",
      "8.0\n",
      "5\n",
      "81\n"
     ]
    }
   ],
   "source": [
    "#============================================\n",
    "# Arithmetic and casting\n",
    "print (\"\\nArithmetic examples:\")\n",
    "print (8 / 3)\n",
    "print (float(8) / 3)\n",
    "print (float(8) / float(3))\n",
    "print (8//3) # must explicitly ask for truncation\n",
    "\n",
    "print (True and False)  # logicals\n",
    "print (8 == 3 )  # logical equallty\n",
    "print (5 <= 6 )  # logical comparison\n",
    "\n",
    "print (2.0*4.0)  # multiplication\n",
    "print (65%6   ) # remainder, modulus\n",
    "print (3**4   ) # 3 to the fourth power"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "String example:\n",
      "A string is double or single quotes\n",
      "Three quote means that the string goes over\n",
      "multiple lines\n",
      "This also spans multiple lines but has no newline\n"
     ]
    }
   ],
   "source": [
    "#============================================\n",
    "# strings example\n",
    "print (\"\\nString example:\")\n",
    "str_val = \"A string is double or single quotes\"\n",
    "str_val_long = '''Three quote means that the string goes over\n",
    "multiple lines'''\n",
    "str_val_no_newline = '''This also spans multiple lines \\\n",
    "but has no newline'''\n",
    "\n",
    "print (str_val)\n",
    "print (str_val_long)\n",
    "print (str_val_no_newline)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "A\n",
      "tr\n",
      "s\n",
      "uotes\n",
      "A string is double or single quotes\n"
     ]
    },
    {
     "ename": "TypeError",
     "evalue": "'str' object does not support item assignment",
     "output_type": "error",
     "traceback": [
      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[1;31mTypeError\u001b[0m                                 Traceback (most recent call last)",
      "\u001b[1;32m<ipython-input-7-94996f1cd364>\u001b[0m in \u001b[0;36m<module>\u001b[1;34m\u001b[0m\n\u001b[0;32m      7\u001b[0m \u001b[0mprint\u001b[0m \u001b[1;33m(\u001b[0m\u001b[0mstr_val\u001b[0m\u001b[1;33m[\u001b[0m\u001b[1;36m0\u001b[0m\u001b[1;33m:\u001b[0m\u001b[1;36m5\u001b[0m\u001b[1;33m]\u001b[0m \u001b[1;33m+\u001b[0m \u001b[0mstr_val\u001b[0m\u001b[1;33m[\u001b[0m\u001b[1;36m5\u001b[0m\u001b[1;33m:\u001b[0m\u001b[1;33m]\u001b[0m\u001b[1;33m)\u001b[0m \u001b[1;31m# print the first five elements, then from the fifth and on\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0;32m      8\u001b[0m \u001b[1;33m\u001b[0m\u001b[0m\n\u001b[1;32m----> 9\u001b[1;33m \u001b[0mstr_val\u001b[0m\u001b[1;33m[\u001b[0m\u001b[1;36m5\u001b[0m\u001b[1;33m]\u001b[0m \u001b[1;33m=\u001b[0m \u001b[1;34m'G'\u001b[0m \u001b[1;31m# this is an error, strings are immutable once they are set\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0m",
      "\u001b[1;31mTypeError\u001b[0m: 'str' object does not support item assignment"
     ]
    }
   ],
   "source": [
    "# string can be accessed in a variety of different ways\n",
    "\n",
    "print (str_val[0]  ) # initial element \"0th\" element\n",
    "print (str_val[3:5]) # elements 3 and 4, but not 5\n",
    "print (str_val[-1] ) # the last element in the string\n",
    "print (str_val[-5:]) # the last five elements\n",
    "print (str_val[0:5] + str_val[5:]) # print the first five elements, then from the fifth and on\n",
    "\n",
    "str_val[5] = 'G' # this is an error, strings are immutable once they are set"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "A string is double or single quotesA string is double or single quotes\n",
      "True\n",
      "Eric\n",
      "a string is double or single quotes\n",
      "A STRING IS DOUBLE OR SINGLE QUOTES\n",
      "['this', ' is', ' separated', ' by', ' commas']\n"
     ]
    }
   ],
   "source": [
    "# some common operations for strings\n",
    "print (str_val*2        ) # mutliply is like adding the number of times, here it repeats the string twice\n",
    "print ('Python' > 'Java') # compare the strings alphabetically \n",
    "\n",
    "print (\"eric\".capitalize()  )# the dot operator works like it does in most other OOP languages\n",
    "print (str_val.lower())\n",
    "print (str_val.upper())\n",
    "print (\"this, is, separated, by, commas\".split(',')) # this results is returned as a list, which we need to talk about!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Tuples, Lists, Sets, and Dictionaries "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[45, 67, 'not a number', 'A string, appended as a new element in the list']\n",
      "[45, 67, 'not a number', 'A string, appended as a new element in the list', ['a list', 'within another list', 442]]\n",
      "['a list', 'within another list', 442]\n",
      "['A string, appended as a new element in the list', ['a list', 'within another list', 442]]\n"
     ]
    }
   ],
   "source": [
    "# A List is one of the most powerful tools in python from which\n",
    "# most abstract types get created and implemented\n",
    "\n",
    "# a list is very much like the mutable version of a tuple\n",
    "# it can hold any type of information\n",
    "a_list = [45, 67, \"not a number\"]\n",
    "\n",
    "# we can add to a list through the append function\n",
    "a_list.append(\"A string, appended as a new element in the list\")\n",
    "\n",
    "print (a_list)\n",
    "\n",
    "# Lists can have other lists in them\n",
    "tmp_list = [\"a list\", \"within another list\", 442]\n",
    "a_list.append(tmp_list)\n",
    "\n",
    "print (a_list)\n",
    "\n",
    "# all of the indexing we learned from before still works with lists\n",
    "print (a_list[-1])\n",
    "print (a_list[-2:])\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "(45, 67, 'not a number')\n",
      "not a number\n"
     ]
    },
    {
     "ename": "TypeError",
     "evalue": "'tuple' object does not support item assignment",
     "output_type": "error",
     "traceback": [
      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[1;31mTypeError\u001b[0m                                 Traceback (most recent call last)",
      "\u001b[1;32m<ipython-input-41-1d451f3d0ff0>\u001b[0m in \u001b[0;36m<module>\u001b[1;34m\u001b[0m\n\u001b[0;32m      8\u001b[0m \u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0;32m      9\u001b[0m \u001b[1;31m# but you cannot change a tuple, its immutable!!\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[1;32m---> 10\u001b[1;33m \u001b[0ma_tuple\u001b[0m\u001b[1;33m[\u001b[0m\u001b[1;36m2\u001b[0m\u001b[1;33m]\u001b[0m \u001b[1;33m=\u001b[0m \u001b[1;34m'hey'\u001b[0m \u001b[1;31m# this will give you an error!!\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0m",
      "\u001b[1;31mTypeError\u001b[0m: 'tuple' object does not support item assignment"
     ]
    }
   ],
   "source": [
    "# tuples are immutable lists and are designated by commas\n",
    "# you can store ANYTHING in side a tuple, its basically a complex object container\n",
    "a_tuple = 45, 67, \"not a number\" \n",
    "print (a_tuple)\n",
    "\n",
    "# you can access a tuple with square brackets\n",
    "print (a_tuple[2])\n",
    "\n",
    "# but you cannot change a tuple, its immutable!!\n",
    "a_tuple[2] = 'hey' # this will give you an error!!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 58,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'apple', 'orange', 'pear', 'banana'}\n",
      "True\n",
      "False\n",
      "{'c', '!', 'b', 'r', 'a', 'd'}\n",
      "{'!', 'd', 'b', 'r'}\n",
      "{'!', 'c', 'b', 'r', 'm', 'z', 'a', 'l', 'd'}\n",
      "{'c', 'a'}\n",
      "{'z', 'd', 'l', 'r', '!', 'b', 'm'}\n"
     ]
    },
    {
     "ename": "AttributeError",
     "evalue": "'frozenset' object has no attribute 'add'",
     "output_type": "error",
     "traceback": [
      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[1;31mAttributeError\u001b[0m                            Traceback (most recent call last)",
      "\u001b[1;32m<ipython-input-58-bf932509e0f6>\u001b[0m in \u001b[0;36m<module>\u001b[1;34m\u001b[0m\n\u001b[0;32m     20\u001b[0m \u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0;32m     21\u001b[0m \u001b[0ma_immutable\u001b[0m \u001b[1;33m=\u001b[0m \u001b[0mfrozenset\u001b[0m\u001b[1;33m(\u001b[0m\u001b[0ma\u001b[0m\u001b[1;33m)\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[1;32m---> 22\u001b[1;33m \u001b[0ma_immutable\u001b[0m\u001b[1;33m.\u001b[0m\u001b[0madd\u001b[0m\u001b[1;33m(\u001b[0m\u001b[1;34m'e'\u001b[0m\u001b[1;33m)\u001b[0m   \u001b[1;31m# the set is immutable, so we cannot add to it, this will give an error!\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0m",
      "\u001b[1;31mAttributeError\u001b[0m: 'frozenset' object has no attribute 'add'"
     ]
    }
   ],
   "source": [
    "# Sets, taken from the Python sets tutorial\n",
    "# https://docs.python.org/2/tutorial/datastructures.html#sets\n",
    "basket = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana']\n",
    "fruit = set(basket) # create a set without duplicates\n",
    "print (fruit)\n",
    "print ('orange' in fruit   ) # fast membership testing\n",
    "print ('crabgrass' in fruit)\n",
    "\n",
    "# Demonstrate set operations on unique letters from two words\n",
    "a = set('abracadabra')\n",
    "b = set('alacazam')\n",
    "a.add('!') # also add the some punctuation\n",
    "\n",
    "# set operations\n",
    "print (a    )   # unique letters in a\n",
    "print (a - b)   # letters in a but not in b\n",
    "print (a | b)   # letters in either a or b\n",
    "print (a & b)   # letters in both a and b\n",
    "print (a ^ b)   # letters in a or b but not both\n",
    "\n",
    "a_immutable = frozenset(a)\n",
    "a_immutable.add('e')   # the set is immutable, so we cannot add to it, this will give an error!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 59,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'dog': 4, 'cat': 4, 'human': 2}\n",
      "4\n",
      "2\n",
      "===============\n",
      "{'dog': 4, 'human': 'two', 'bird': 'two and some wings', 45: 'a key that is not a string'}\n"
     ]
    }
   ],
   "source": [
    "# Dictionaries map keys to values.\n",
    "\n",
    "# Here we setup a key as a string and the value as a number\n",
    "num_legs = { 'dog': 4, 'cat': 4, 'human': 2 }\n",
    "\n",
    "# You access Subscripts via the \"key\"\n",
    "print (num_legs)\n",
    "print (num_legs['dog'])\n",
    "print (num_legs['human'])\n",
    "\n",
    "print ('===============')\n",
    "# Entries can be added, updated, or deleted.\n",
    "# Again, these are just containers for any memory type\n",
    "num_legs['human'] = 'two'\n",
    "num_legs['bird'] = 'two and some wings'\n",
    "num_legs[45] = 'a key that is not a string' # notice that the key does not need to be a string\n",
    "# the key just needs to be some immutable memory\n",
    "\n",
    "del num_legs['cat']\n",
    "print (num_legs)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# ADTs, Loops, and Conditionals"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 60,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "for loop output:\n",
      "DataMining <class 'str'>\n",
      "This statement is in the loop\n",
      "8 <class 'int'>\n",
      "This statement is in the loop\n",
      "23423423235 <class 'int'>\n",
      "This statement is in the loop\n",
      "2.546923764237654 <class 'float'>\n",
      "This statement is in the loop\n",
      "False <class 'bool'>\n",
      "This statement is in the loop\n",
      "This statement is outside the loop\n"
     ]
    }
   ],
   "source": [
    "\n",
    "#============================================\n",
    "# for loop example with list\n",
    "print (\"\\nfor loop output:\")\n",
    "\n",
    "list_example = [int_val, long_val, float_val, bool_val]\n",
    "list_example.insert(0, \"DataMining\")\n",
    "\n",
    "# notice that the loop ends with a colon and \n",
    "# is designated by the tab alignment\n",
    "for val in list_example:\n",
    "    print (str(val) + ' ' + str(type(val)))\n",
    "    print (\"This statement is in the loop\")\n",
    "    \n",
    "print (\"This statement is outside the loop\")\n",
    "    "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 61,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "=================\n",
      "0\n",
      "1\n",
      "3\n",
      "6\n",
      "10\n",
      "15\n",
      "21\n",
      " A. leaving the loop on break\n"
     ]
    }
   ],
   "source": [
    "import random\n",
    "print ('=================')\n",
    "val = 0\n",
    "for i in range(0, random.randint(1, 10) ):\n",
    "    val += i\n",
    "    print (val)\n",
    "    if val>20:\n",
    "        print (' A. leaving the loop on break')\n",
    "        break # break out of loop\n",
    "else: # this else belongs to the for loop\n",
    "    print ('B. exiting for loop without break')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 62,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "DataMining \t is at index \t 0\n",
      "8 \t is at index \t 1\n",
      "23423423235 \t is at index \t 2\n",
      "2.546923764237654 \t is at index \t 3\n",
      "False \t is at index \t 4\n"
     ]
    }
   ],
   "source": [
    "# more for loop examples\n",
    "\n",
    "# you can also get the index using the enumerate example\n",
    "for index, val in enumerate(list_example):\n",
    "    print (str(val), '\\t is at index \\t', index)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 63,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "===============\n",
      "What is your name?  It is lancelot.\n",
      "What is your quest?  It is the holy grail.\n",
      "What is your favorite color?  It is blue.\n"
     ]
    }
   ],
   "source": [
    "print ('===============')\n",
    "# this is a classic example for zipping, provided by the official python tutorial\n",
    "# notice the references to Monty Python\n",
    "\n",
    "# say you have two lists of equal size, that you would like to \n",
    "# loop through without indexing, you can use the \"zip\" function\n",
    "questions = ['name', 'quest', 'favorite color']\n",
    "answers = ['lancelot', 'the holy grail', 'blue']\n",
    "for q, a in zip(questions, answers):\n",
    "    print ('What is your %s?  It is %s.' % (q, a))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 64,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "===============\n",
      "dict_keys(['dog', 'human', 'bird', 45])\n",
      "dog => 4\n",
      "human => two\n",
      "bird => two and some wings\n",
      "45 => a key that is not a string\n",
      "===============\n",
      "dog => 4\n",
      "human => two\n",
      "bird => two and some wings\n",
      "45 => a key that is not a string\n",
      "===============\n",
      "human => two\n",
      "beast is not present.\n",
      "cat is not present.\n",
      "dog => 4\n",
      "45 => a key that is not a string\n"
     ]
    }
   ],
   "source": [
    "# Looping through dictionaries\n",
    "print ('===============')\n",
    "# Get all the keys.\n",
    "print (num_legs.keys())\n",
    "for k in num_legs.keys():\n",
    "    print (k, \"=>\", num_legs[k])\n",
    "\n",
    "print ('===============')\n",
    "# you can also use the iter_items function\n",
    "for k, v in num_legs.items():\n",
    "    print (k, \"=>\", v)\n",
    "\n",
    "print ('===============')\n",
    "# Test for presence of a key.\n",
    "for t in [ 'human', 'beast', 'cat', 'dog', 45 ]:\n",
    "    print (t,end=' ')\n",
    "    if t in num_legs:\n",
    "        print ('=>', num_legs[t])\n",
    "    else:\n",
    "        print ('is not present.')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 65,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[0, 1, 16, 81, 256, 625, 1296, 2401, 4096, 6561]\n",
      "['NAME', 'QUEST', 'FAVORITE COLOR']\n",
      "{0: 0, 1: 1, 2: 16, 3: 81, 4: 256, 5: 625, 6: 1296, 7: 2401, 8: 4096, 9: 6561}\n",
      "260\n"
     ]
    }
   ],
   "source": [
    "# list comprehensions and dictionary comprehensions\n",
    "\n",
    "# comprehensions are like shorthand for loops where each\n",
    "# pass through the loop saves the result in a list or dictionary\n",
    "\n",
    "# for example, imagine we want to take every element in a range to the fourth power\n",
    "times_four = [x**4 for x in range(10)]\n",
    "print (times_four)\n",
    "# this save the fourth power of the numbers 0 through 9\n",
    "# the result of each pass through the loop saves a value\n",
    "# in other languages this is also known as \"lambda functions\"\n",
    "\n",
    "# you can also call functions inside a comprehension, and take \n",
    "# advantage of the data type. For example, if each element is a string\n",
    "# we can use the string member methods\n",
    "questions = ['name', 'quest', 'favorite color']\n",
    "quest_upper = [x.upper() for x in questions]\n",
    "print (quest_upper)\n",
    "\n",
    "# you can also do comprehensions with dictionaries\n",
    "times_four = {x:x**4 for x in range(10)}\n",
    "# notice that the comprehension is wrapped in curly braces and the key for the value \n",
    "# is given inside the code itself, followed by a colon\n",
    "print (times_four)\n",
    "\n",
    "# you can also nest comprehensions inside each other, but this is not always good coding practice\n",
    "# especially if it makes the code less readable\n",
    "\n",
    "# Finally, all of the enumerate, zipping, and slicing we performed also applies to \n",
    "# list comprehensions\n",
    "x_array = [10, 20, 30]\n",
    "y_array = [7, 5, 3]\n",
    "# this prints the sum of the multiplication of the arrays\n",
    "print (sum(x*y for x,y in zip(x_array, y_array)) ) \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 66,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Stack Example:\n",
      "['LIFO', 0, 1, 2, 3, 4]\n",
      "=============\n",
      "4\n",
      "=============\n",
      "['LIFO', 0, 1, 2, 3]\n",
      "=============\n"
     ]
    }
   ],
   "source": [
    "#============================================\n",
    "# array as a stack\n",
    "print (\"\\nStack Example:\")\n",
    "list_example = []\n",
    "list_example.append('LIFO')\n",
    "\n",
    "for i in range(0, 5):\n",
    "    list_example.append(i)\n",
    "\n",
    "print (list_example)\n",
    "print (\"=============\")\n",
    "val = list_example.pop()\n",
    "print (val)\n",
    "print (\"=============\")\n",
    "print (list_example)\n",
    "print (\"=============\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 67,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Queue Example:\n",
      "deque([9, 8, 7, 6, 5, 'FIFO'])\n",
      "=============\n",
      "FIFO\n",
      "=============\n",
      "deque([9, 8, 7, 6, 5])\n",
      "=============\n",
      "5\n",
      "6\n",
      "7\n",
      "8\n",
      "9\n"
     ]
    }
   ],
   "source": [
    "#============================================\n",
    "# array as a queue\n",
    "print (\"\\nQueue Example:\")\n",
    "from collections import deque # this is an import, we will get back to that later\n",
    "# essentially this is a set of utility functions shipped with python\n",
    "\n",
    "q_example = deque()\n",
    "q_example.appendleft(\"FIFO\")\n",
    "for i in range(5, 10):\n",
    "    q_example.appendleft(i)\n",
    "\n",
    "print (q_example)\n",
    "print (\"=============\")\n",
    "val = q_example.pop()\n",
    "print (val)\n",
    "print (\"=============\")\n",
    "print (q_example)\n",
    "print (\"=============\")\n",
    "\n",
    "# pop and print each element\n",
    "while len(q_example) > 0:\n",
    "    print (q_example.pop())"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 68,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Conditional Example:\n",
      "a is true\n",
      "b is false\n"
     ]
    }
   ],
   "source": [
    "#============================================\n",
    "# conditional example\n",
    "print (\"\\nConditional Example:\")\n",
    "\n",
    "a, b = True, False  # double assignment\n",
    "\n",
    "if a:\n",
    "    print (\"a is true\")\n",
    "elif a or b:\n",
    "    print (\"b is true\")\n",
    "else:\n",
    "    print (\"neither a or b are true\")\n",
    "\n",
    "# conditional assignment\n",
    "val = \"b is true\" if b else \"b is false\"\n",
    "print (val)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 69,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "I. Everybody is a five!\n",
      "II. These are the same object!\n",
      "III. Wish we had the same objects...\n",
      "IV. Everybody is a five!\n",
      "V. Wish we had fives...\n",
      "VI. Got through nested conditional\n"
     ]
    }
   ],
   "source": [
    "# more on conditionals, \"is\" versus ==\n",
    "\n",
    "# I. the traditional == works as expected\n",
    "a=5\n",
    "b=5\n",
    "if a==b:\n",
    "    print (\"I. Everybody is a five!\")\n",
    "else:\n",
    "    print (\"I. Wish we had fives…\" )\n",
    "    \n",
    "# II. the \"is\" function is for object comparison, much like comparing pointers\n",
    "a=327676\n",
    "b=a\n",
    "if a is b:\n",
    "    print (\"II. These are the same object!\")\n",
    "else:\n",
    "    print (\"II. Wish we had the same objects...\" )\n",
    "    \n",
    "# III. while these have the same value, they are not the same memory\n",
    "a=327676\n",
    "b=327675+1\n",
    "if a is b:\n",
    "    print (\"III. These are the same object!\")\n",
    "else:\n",
    "    print (\"III. Wish we had the same objects...\" )\n",
    "\n",
    "# IV. you would expect this to say wish we had fives,\n",
    "# but small integers like this are cached so right now they do point to the same memory\n",
    "a=5\n",
    "b=4+1\n",
    "if a is b:\n",
    "    print (\"IV. Everybody is a five!\")\n",
    "else:\n",
    "    print (\"IV. Wish we had fives...\" )\n",
    "    \n",
    "# V. but if we change the memory, that caching gets released\n",
    "b = b*2.0\n",
    "b = b/2.0\n",
    "if a is b:\n",
    "    print (\"V. Everybody is a five!\")\n",
    "else:\n",
    "    print (\"V. Wish we had fives...\")\n",
    "    \n",
    "# you can also perform nested conditionals, like bounding\n",
    "if 5 < 8 < 6: # not true because 8 is not less than 6\n",
    "    print ('VI. How did we get here')\n",
    "elif 4 < 18 < 22:\n",
    "    print (\"VI. Got through nested conditional\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Pythonic\n",
    "Now that we have gone through a consierable number of examples and data types, we need to talk about what it means to write code in python that is \"pythonic\". In a nutshell, there are many ways to implement something in python. The \"best\" method is one that is readable, simple, and brief. \n",
    "\n",
    "There many different coding “styles”\n",
    "+ “best” styles get the distinction of “pythonic”\n",
    "    + ill formed definition\n",
    "    + changes as the language matures\n",
    "+ pythonic code is:\n",
    "    + simple and readable\n",
    "    + uses dynamic typing when possible\n",
    "    + uses underscores to separate names\n",
    "    + names of variables are distinctive\n",
    "+ …or to quote Tim Peters…, run the next cell\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The Zen of Python, by Tim Peters\n",
      "\n",
      "Beautiful is better than ugly.\n",
      "Explicit is better than implicit.\n",
      "Simple is better than complex.\n",
      "Complex is better than complicated.\n",
      "Flat is better than nested.\n",
      "Sparse is better than dense.\n",
      "Readability counts.\n",
      "Special cases aren't special enough to break the rules.\n",
      "Although practicality beats purity.\n",
      "Errors should never pass silently.\n",
      "Unless explicitly silenced.\n",
      "In the face of ambiguity, refuse the temptation to guess.\n",
      "There should be one-- and preferably only one --obvious way to do it.\n",
      "Although that way may not be obvious at first unless you're Dutch.\n",
      "Now is better than never.\n",
      "Although never is often better than *right* now.\n",
      "If the implementation is hard to explain, it's a bad idea.\n",
      "If the implementation is easy to explain, it may be a good idea.\n",
      "Namespaces are one honking great idea -- let's do more of those!\n"
     ]
    }
   ],
   "source": [
    "#import this # the zen of python\n",
    "import this"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Pop Quiz!!!\n",
    "Which of these is more pythonic: You want to add the numbers between zero and N. \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "8128\n",
      "8128\n",
      "8128.0\n"
     ]
    }
   ],
   "source": [
    "N = 128\n",
    "\n",
    "sum_value = 0\n",
    "for i in range(N):\n",
    "    sum_value += i\n",
    "print (sum_value)\n",
    "\n",
    "# OR\n",
    "print (sum(range(N)))\n",
    "\n",
    "# OR\n",
    "print (N*(N-1)/2 )"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Functions and Classes"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Function Example:\n",
      "upper case\n",
      "data mining\n"
     ]
    }
   ],
   "source": [
    "#============================================\n",
    "print (\"\\nFunction Example:\")\n",
    "\n",
    "# create and call a function\n",
    "# the function can be defined almost anywhere in file, as long as it is defined before it gets used\n",
    "def make_strings_lowercase(str_input):\n",
    "    assert isinstance(str_input, str)  # test the type of input\n",
    "    return str_input.lower()\n",
    "\n",
    "# now we are back on the main execution\n",
    "print (make_strings_lowercase(\"UPPER CASE\"))\n",
    "print (make_strings_lowercase(\"Data Mining\"))\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[1, 2, 3, 4, 5]\n",
      "====================\n",
      "[1, 2, 3, 4, 5]\n",
      "[1, 2, 3, 4, 5]\n",
      "a cool X value\n",
      "[1, 2, 3, 4, 5]\n",
      "a cool X value\n",
      "a cool Y value\n",
      "====================\n",
      "(4, 1024)\n"
     ]
    }
   ],
   "source": [
    "# more functions examples\n",
    "def show_data(data):\n",
    "    # print the data\n",
    "    print (data)\n",
    "\n",
    "some_data = [1,2,3,4,5]\n",
    "show_data(some_data)\n",
    "\n",
    "# you can also define default values for the functions\n",
    "print ('====================')\n",
    "def show_data(data,x=None,y=None):\n",
    "    # print the data\n",
    "    print (data)\n",
    "    if x is not None:\n",
    "        print (x)\n",
    "    if y is not None:\n",
    "        print (y)\n",
    "\n",
    "some_data = [1,2,3,4,5]\n",
    "show_data(some_data);\n",
    "show_data(some_data,x='a cool X value')\n",
    "show_data(some_data,y='a cool Y value',x='a cool X value') \n",
    "\n",
    "# as well as have multiple return types in the function\n",
    "print ('====================')\n",
    "def get_square_and_tenth_power(x):\n",
    "    return x**2,x**10\n",
    "\n",
    "print (get_square_and_tenth_power(2) )\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "name: Heart has 1 beats per second\n",
      "This is a long string meant to be so long that the memory for it is not cached by python\n",
      "True\n",
      "False\n"
     ]
    }
   ],
   "source": [
    "# This is a class that inherits from a generic object\n",
    "class BodyPart(object):\n",
    "    kind = \"This is a long string meant to be so long that the memory for it is not cached by python\"\n",
    "    # this is a class variable, shared across all instances\n",
    "    def __init__(self,name):\n",
    "        self.name = name # the name attribute is unique to each instance of the BodyPart class\n",
    "\n",
    "# now define a class that sub classes from the defined BodyPart CLass\n",
    "class Heart(BodyPart):\n",
    "    def __init__(self,rate=60,units=\"minute\"):\n",
    "        self.rate = rate\n",
    "        self.units= units\n",
    "        super(Heart,self).__init__(\"Heart\")\n",
    "\n",
    "    def __str__(self):\n",
    "        return \"name: \" + str(self.name) + \" has \" + str(self.rate) + \" beats per \" + self.units\n",
    "        \n",
    "\n",
    "my_heart = Heart(1,\"second\")\n",
    "print(my_heart)\n",
    "\n",
    "generic_part = BodyPart(\"Foot\")\n",
    "print (my_heart.kind)\n",
    "print (my_heart.kind is generic_part.kind) # true, these are the same memory location\n",
    "\n",
    "# take the following for example, these are not the same object\n",
    "a = \"This is a long string meant to be so long that the memory for it is not cached by python\"\n",
    "b = \"This is a long string meant to be so long that the memory for it is not cached by python\"\n",
    "print (a is b) # not the same memory location"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "6 2\n",
      "A: 0.0\n",
      "\n",
      "Division by zero.\n"
     ]
    }
   ],
   "source": [
    "# error handling and exceptions\n",
    "# Python exception handling.\n",
    "\n",
    "# example reissued from: http://sandbox.mc.edu/~bennet/python/code/exc_py.html\n",
    "\n",
    "# Choose two random integers.\n",
    "import random\n",
    "i = random.randrange(0, 8)\n",
    "j = random.randrange(-1, 6)\n",
    "print( i, j)\n",
    "\n",
    "# Get a nice little array, then try a bunch of dangerous stuff.\n",
    "some = [3, 10, 0, 8, 18];\n",
    "try:\n",
    "    # We try to execute this block.\n",
    "    den = some[j] / i\n",
    "    print (\"A:\", den)\n",
    "    frac = (i + j) / den\n",
    "    print (\"B:\", frac)\n",
    "    if frac < 2:\n",
    "        k = 3\n",
    "    else:\n",
    "        k = 'mike'\n",
    "    print (\"C:\", k)\n",
    "    print (\"D:\", some[k])\n",
    "# This is the catch block.\n",
    "except ZeroDivisionError:\n",
    "    print (\"\\nDivision by zero.\")\n",
    "except TypeError as inst:\n",
    "    # The detail provides extra information about the exception.\n",
    "    print (\"\\nSome type mismatch:\", inst)\n",
    "except IndexError as inst:\n",
    "    print (\"\\nSome value is out of range:\", inst)\n",
    "except:\n",
    "    # Except without an exception name catches any exception.\n",
    "    print (\"\\nSomething else went wrong.\")\n",
    "\n",
    "# An else attached to an except block is run if no exception occurrs.\n",
    "else:\n",
    "    print (\"\\nThat's odd, nothing went wrong.\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Could not read file: [Errno 2] No such file or directory: 'some_file.txt'\n"
     ]
    }
   ],
   "source": [
    "# the with command and opening a file\n",
    "\n",
    "# the regular way of opening a file, lots of error checking\n",
    "try:\n",
    "    file = None\n",
    "    file = open(\"some_file.txt\")\n",
    "    data = file.read()\n",
    "except IOError as inst:\n",
    "    print (\"\\nCould not read file:\", inst)\n",
    "else:\n",
    "    print (\"Read successfully, file contents:\")\n",
    "    print (data)\n",
    "finally:\n",
    "    # this always gets called, close the file if its open\n",
    "    if file!= None and not file.closed:\n",
    "        file.close()\n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "ename": "FileNotFoundError",
     "evalue": "[Errno 2] No such file or directory: 'some_file.txt'",
     "output_type": "error",
     "traceback": [
      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[1;31mFileNotFoundError\u001b[0m                         Traceback (most recent call last)",
      "\u001b[1;32m<ipython-input-9-d8ca60814820>\u001b[0m in \u001b[0;36m<module>\u001b[1;34m\u001b[0m\n\u001b[0;32m      5\u001b[0m \u001b[1;31m# in that respect, the \"with\" statement is a protocol that the \"file class\" adopts\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0;32m      6\u001b[0m \u001b[1;33m\u001b[0m\u001b[0m\n\u001b[1;32m----> 7\u001b[1;33m \u001b[1;32mwith\u001b[0m \u001b[0mopen\u001b[0m\u001b[1;33m(\u001b[0m\u001b[1;34m\"some_file.txt\"\u001b[0m\u001b[1;33m)\u001b[0m \u001b[1;32mas\u001b[0m \u001b[0mfile\u001b[0m\u001b[1;33m:\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0m\u001b[0;32m      8\u001b[0m     \u001b[0mdata\u001b[0m \u001b[1;33m=\u001b[0m \u001b[0mfile\u001b[0m\u001b[1;33m.\u001b[0m\u001b[0mread\u001b[0m\u001b[1;33m(\u001b[0m\u001b[1;33m)\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n\u001b[0;32m      9\u001b[0m     \u001b[0mprint\u001b[0m \u001b[1;33m(\u001b[0m\u001b[1;34m\"Read successfully, file contents:\"\u001b[0m\u001b[1;33m)\u001b[0m\u001b[1;33m\u001b[0m\u001b[1;33m\u001b[0m\u001b[0m\n",
      "\u001b[1;31mFileNotFoundError\u001b[0m: [Errno 2] No such file or directory: 'some_file.txt'"
     ]
    }
   ],
   "source": [
    "# the \"file\" class actually has a built in __init__ and __exit__\n",
    "# so we can really on their class implemntation to close the file propoerly\n",
    "# and handle any exceptions gracefully\n",
    "\n",
    "# in that respect, the \"with\" statement is a protocol that the \"file class\" adopts\n",
    "\n",
    "with open(\"some_file.txt\") as file:\n",
    "    data = file.read()\n",
    "    print (\"Read successfully, file contents:\")\n",
    "    print (data)\n",
    "\n",
    "# is the file closed? Let's check\n",
    "print (file.closed)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "1. Just initialized body part with name Lungs\n",
      "2. Building up from \"with\" command\n",
      "3. Hi, my name is: Lungs\n",
      "4. Exit was called, no errors\n"
     ]
    }
   ],
   "source": [
    "# you can also define your own classes that adopt the \"with\" protocol,\n",
    "# if you are interested check out the example \n",
    "class BodyPart(object):\n",
    "    def __init__(self,name):\n",
    "        self.name = name\n",
    "        print ('1. Just initialized body part with name', name)\n",
    "        \n",
    "    def __enter__(self):\n",
    "        print ('2. Building up from \"with\" command' )\n",
    "        return self\n",
    "        \n",
    "    def __exit__(self, type, value, traceback):\n",
    "        if value is not None:\n",
    "            print ('4. An error occurred,', value)\n",
    "        else:\n",
    "            print ('4. Exit was called, no errors')\n",
    "            \n",
    "    def __str__(self):\n",
    "        # 5/0 # uncomment to raise an error\n",
    "        return '3. Hi, my name is: '+ self.name\n",
    "\n",
    "with BodyPart(\"Lungs\") as bp:\n",
    "    print(bp)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Importing Libraries\n",
    "Python shipd with many libraries already packaged. You simply import them using the \"import\" command. However, you can also install many third party libraries, of which there are many for data wrangling. In the next examples we will use some built in libraries, as well as ones that are third party.\n",
    "\n",
    "For installing the third party libraries, you will need to install a package mananger. There are three main ones that you may want to use on your system:\n",
    "+ Pip, https://pypi.python.org/pypi/pip\n",
    "+ Homebrew, http://brew.sh\n",
    "+ Macports, https://www.macports.org\n",
    "    \n",
    "I have had the best luck using pip (even on mac, after installing brew). But you will need to explore the options and decide which one is right for your system. If you are using windows, pip is the way to go. If you do not want the setup to affect other libraries installed on your system, consider setting up a virtual environment. http://docs.python-guide.org/en/latest/dev/virtualenvs/\n",
    "\n",
    "Now go our and install the Numpy and Matplotlib systems on your system! It might be as simple as:\n",
    "     > pip install numpy\n",
    "     > pip install matplotlib"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "0.9998741276738751\n",
      "-1.2246467991473532e-16\n"
     ]
    }
   ],
   "source": [
    "# with the package installed, we can import the libraries and use them.\n",
    "\n",
    "# The numpy package is great for working with groups of numbers as matrices\n",
    "# and has many functionalities that are comparable to Matlab and Octave\n",
    "import numpy as np\n",
    "t = np.linspace(0, 1, 100)  # 100 equally spaced array of numbers from 0.0 to 1\n",
    "y = np.sin(2 * np.pi * t)  # take sine of the value\n",
    "\n",
    "print (np.max(y))\n",
    "print (np.median(y))\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Matplotlib has a number of plotting tools that are extremely powerful for\n",
    "# exploring data. The plotting functionality is simliar to R, but many times\n",
    "# it is easier of more customizable. \n",
    "# Note: everthying you know in \"R\" will come back full circle. Python and R play very \n",
    "#   nicely with one another and python can call R code, share memory with it, and use its plotting functions\n",
    "#   ...with the correct libraries installed! Check out Rpy2, http://rpy.sourceforge.net \n",
    "\n",
    "%matplotlib inline\n",
    "\n",
    "#============================================\n",
    "# plotting example\n",
    "from matplotlib import pyplot as plt\n",
    "\n",
    "plt.plot(t, y)  # plot them\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "2.6.0\n"
     ]
    }
   ],
   "source": [
    "# this library ships with python and is for accessing SQL\n",
    "# You will learn how to use the module more extensively in the future!\n",
    "# here, we will just import it and get its version\n",
    "import sqlite3\n",
    "\n",
    "print (sqlite3.version)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Debugging\n",
    "\n",
    "Debugging in python is much like any other programming language. If you use the command line to run programs, you need to be able to catch and interpret runtime errors. There is no compilation process (that we have talked about), so all errors will occur at runtime--that includes things like spelling errors. Because of this, it is critical to run your code in varying contexts. That also means exploring ways that it could fail by changing the values of different variables.\n",
    "\n",
    "One easy way to do this is by the using the pdb package. You can run it from the iPython notebook, but it gets quite long on the output trace. You will likely want to copy this test over to another document (for example, debugging.py) and run it from the command line (for example, >python debugging.py). The pdb library allows you to set break points in the files and also step through the program, changing the variable values. \n",
    "\n",
    "+ import pdb\n",
    "    + pdb.set_trace()\n",
    "+ command line arguments\n",
    "    + s(tep), c(ontinue), n(ext), w(here), l(ist), r(eturn), j(ump)\n",
    "+ and much more… like print, p, pp\n",
    "+ can set numbered break points by running from python window\n",
    "    + python -m pdb your_function.py "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "> <ipython-input-2-3f17a447e4b8>(4)<module>()\n",
      "-> for i in range(0,5):\n",
      "(Pdb) c\n",
      "> <ipython-input-2-3f17a447e4b8>(4)<module>()\n",
      "-> for i in range(0,5):\n",
      "(Pdb) c\n",
      "> <ipython-input-2-3f17a447e4b8>(4)<module>()\n",
      "-> for i in range(0,5):\n",
      "(Pdb) c\n",
      "> <ipython-input-2-3f17a447e4b8>(4)<module>()\n",
      "-> for i in range(0,5):\n",
      "(Pdb) c\n",
      "> <ipython-input-2-3f17a447e4b8>(4)<module>()\n",
      "-> for i in range(0,5):\n",
      "(Pdb) c\n",
      "50\n"
     ]
    }
   ],
   "source": [
    "import pdb\n",
    "\n",
    "j = 0\n",
    "for i in range(0,5):\n",
    "    j += 5*i\n",
    "    pdb.set_trace()\n",
    "    \n",
    "print (j)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There is still plenty more to learn about python, but now you have the basics. One topic that may be intersting to you is the concept of decorators, discussed here:\n",
    "    http://simeonfranklin.com/blog/2012/jul/1/python-decorators-in-12-steps/\n",
    "    \n",
    "Essentially, decorators are ways of manipulating functions with other functions. Mostly, this means recycling the functionality of one function to create a new function. \n",
    "\n",
    "There is also much to be learned about iterators, yield, etc. Python is an active language and it is still evolving!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "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.7.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}