updated readme.md, setup.py and added examples