Checked python files with Flake8

This ensures that they all are consistent in style with PEP-8
Improved docstrings

This should bring the program more into line with PEP-257