Updated Readme; with bits merged from polaron gist

Polaron gist previously found here: https://gist.github.com/jarvist/2923213