names changes to match PEP8 plus more docstrings

Variable and function names updated to match PEP8. Various docstrings
added.