changing base directory to a name more appropriate for the module contained
cleaning up the interface and documentation, and adding a few new methods to WeightedSelection
fixing some documentation and adding some better code comments, especially to the consolidate routine