This is the set up updates to finish moving urbansim to the new simulation framework

Works for me, just document it. Any function/method that returns something should have that documented in a `Returns` section as described here: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#sections.