It would be better to follow standard `numpy`/`scipy` style guidelines for this docstring, to stay consistent with the rest of the codebase.