Updates to Python API

comments added as docstrings to operation functions