slightly code style improvements according to PEP8
including:
- code commenting
- variable names
- code formatting