Move examples to separate py files and update README

Closes #11 and #17.
This is a rebase/squash of the commits from pull request #17.