Note:  I'm not familiar with the numpydoc format but we should conform to that for the sake of consistency.