Update readme.md regarding model initialisation, documentation and minor changes