DOC: improved docstring
EHN: from fraction to weight