Programming with Python

This lesson is written as an introduction to Python, but its real purpose is to introduce the single most important idea in programming: how to solve problems by building functions, each of which can fit in a programmer's working memory. In order to teach that, we must teach people a little about the mechanics of manipulating data with lists and file I/O so that their functions can do things they actually care about. Our teaching order tries to show practical uses of every idea as soon as it is introduced; instructors should resist the temptation to explain the "other 90%" of the language as well.

The secondary goal of this lesson is to give them a usable mental model of how programs run (what computer science educators call a notional machine so that they can debug things when they go wrong. In particular, they must understand how function call stacks work.

The final example asks them to build a command-line tool that works with the Unix pipe-and-filter model. We do this because it is a useful skill and because it helps learners see that the software they use isn't magical. Tools like grep might be more sophisticated than the programs our learners can write at this point in their careers, but it's crucial they realize this is a difference of scale rather than kind.

Teaching Notes

  • Explain that we use Python because:
    • It's free.
    • It has a lot of scientific libraries, and more are constantly being added.
    • It has a large scientific user community.
    • It's easier for novices to learn than most of the mature alternatives. (Software Carpentry originally used Perl; when we switched, we found that we could cover as much material in two days in Python as we'd covered in three days in Perl, and that retention was higher.)
  • We do not include instructions on running the IPython Notebook in the tutorial because we want to focus on the language rather than the tools. Instructors should, however, walk learners through some basic operations:
    • Launch from the command line with ipython notebook.
    • Create a new notebook.
    • Enter code or data in a cell and execute it.
    • Explain the difference between In[#] and Out[#].
  • Watching the instructor grow programs step by step is as helpful to learners as anything to do with Python. Resist the urge to update a single cell repeatedly (which is what you'd probably do in real life). Instead, clone the previous cell and write the update in the new copy so that learners have a complete record of how the program grew. Once you've done this, you can say, "Now why don't we just breaks things into small functions right from the start?"

  • The discussion of command-line scripts assumes that students understand standard I/O and building filters, which are covered in the lesson on the shell.

  • Do not start the notebook with:

    ipython notebook --pylab [backend]
    

    The --pylab option has been deprecated for a long time, and is being removed soon.