ENH: updated README and added examples file.