ENH: various enhancements

- improve performance (thanks Eric!)
- improve example
- update test
- add comments to clust_level.py I had been happy about when starting.