explain the adjustment heuristics in javadocs instead of inline (or in addition to)

maybe add to the javadocs of this class that it is intended to be re-used on similar data sets because it tries to adjust accordingly