=added weighted second moment function.
=changed documentation notation for kwargs to use -> to indicate which function will receive which keyword argument.