minor change to usage
various refactorying thanks to pycharm
updated README.md