[FEA] Balanced k-means expose hierarchy to user #2857

The balanced k-means currently builds a hierarchy interally and then throws it away to yield the flat set of clusters. Several users have requested that we expose the hierarchy to them, since this can carry important information on its own.