Updates to README, fixes to filtering, optional arguments and expanded examples

Hi Mike

I noticed this was already forked from the older version.  So I'm sending a pull request to merge the recent changes.