Python comments should be corrected

[RJSSimpson]

In this work we try and stick by PEP8 comment standards (http://www.python.org/dev/peps/pep-0008/).

Many comments in the Python code are currently like this
"This is a comment."

However they should all be like this
# This is a comment.