Update README.md

Added Documentation link to the README file.

Added MPI support for run from the Python Interpreter. Improved print…

… outs, examples, and README file.