Add more information to README.md

[tbanyard]

It would be good to have more descriptions of what each python file/module does, and how they link together, in the README.md file.