TS map calculator update and docs

Modified command line tool to work with different pixels sizes. Added some documentation and brief tutorial.
Add returns section (even if it's obvious .... always document inputs / outputs).