improved documentation
moved python module to top level so that it can be more easily installed by pip