TS map calculator update and docs

Modified command line tool to work with different pixels sizes. Added some documentation and brief tutorial.
As discussed ... remove the ``debug`` option and also from the description here.