adding code comments, etc.
adding a notebook to get statistics on the occ matching
updates