README and code style issues

* PEP8 formatting
* Extended README file
* Some smaller Python code issues