updated docstrings on iterator.py fixes #573
updated doctest in spatial.py. fixes #559
Merge pull request #591 from johnchase/master

fixes some issues