TS map calculator update and docs

Modified command line tool to work with different pixels sizes. Added some documentation and brief tutorial.
Adding this here leads to the content being listed twice in the API docs:
![screen shot 2014-12-12 at 15 24 58](https://cloud.githubusercontent.com/assets/852409/5413038/125b4978-8213-11e4-9aad-7c9422c6ffee.png)

You should remove it.
If something doesn't show up in the sphinx docs it's because it's missing in the `__all__` list.