Added function documentation.

Added
=====

* numpydoc-style documentation for functions in raster_funcs.py.
* Added doctests for functions.
Added deprecated sections.
Merge pull request #17 from mcflugen/fix-raster_funcs-docs

Fixed documentation for raster_funcs.py