update readme; add a couple of useful functions