Don't like "float weights". 
According to http://scitools.org.uk/iris/docs/latest/developers_guide/documenting/docstrings.html#sample-multi-line-docstring, we should really be including typing info within the header, but unfortunately most of the rest of this module is not really complying with that.
Your call.