This section should probably be updated. See https://github.com/reproducible-research/scipy-tutorial-2014/blob/master/documents/LiterateProgramming.md