updated documentation in REAME.md and in hlevel.py