support ipython execution in documentation

Add an ipython directive to the documentation which supports direct execution
of Python and the embedding of plot results. Add in the infrastructure required
to support building this straight from ``python setup.py build_sphinx`` and
readthedocs.

As an example, an ipython-based example is added to the image registration
section.