added two new utilities and some more docstrings.  The new utils come
from @ChrisBeaumont and @astrofrog