this docstring needs love.

If you reference a function in an external lib you can link to it using sphinx thus:

    :func:`scipy.ndimage.interpolation.affine_transform`

or

    :func:`skimage.transform.warp`