added readme's and python docstrings