NAME

TransverseMercatorTest -- convert between geographic and transverse Mercator


SYNOPSIS

TransverseMercatorTest [ -r ] [ -s | -t ] [ --version | -h | --help ]


DESCRIPTION

Convert between geographic coordinates and transverse Mercator coordinates.

Read lines with latitude and longitude (or easting and northing if -r is specified) from standard input and print latitude, longitude, easting, northing, convergence, and scale. Units are decimal degrees (or degrees, minutes, seconds) and meters.

By default, the WGS84 is ellipsoid is used (a = 6378137m, f = 1/298.257223563), with central meridian = 0, UTM central scale (0.9996), and false easting and false northing = 0. This is affected by the -t option.


OPTIONS

-r

perform the reverse projection; (the inputs are easting and northing).

-s

use the sixth-order Krueger series approximation to the transverse Mercator projection instead of the exact projection.

-t

use an ellipsoid of eccentricity 0.1, central scale = 1, 1/4 meridian = 1. In addition, the cut in the exact transverse Mercator projection at northing = 0 is removed. The domain of latitude (lat) and longitude (lon) is the union of

    lat in [0, 90]  and lon in [0, 90]
    lat in (-90, 0] and lon in [81, 90]

The domain of easting (x) and northing (y) is the union of

    x in [0, inf)       and y in [0, 1]
    x in [1.71..., inf) and y in (-inf, 0]
--version

print version.

-h

print usage.

--help

print full documentation.


EXAMPLES

   echo 0 90 | TransverseMercatorTest
   => 0 90 25953592.84 9997964.94 90 18.40
   echo 260e5 100e5 | TransverseMercatorTest -r
   => -0.02 90.00 26000000 10000000 90.01 18.47


ERRORS

An illegal line of input will print an error message to standard output beginning with ERROR: and causes TransverseMercatorTest to return an exit code of 1. However, an error does not cause TransverseMercatorTest to terminate; following lines will be converted.


SEE ALSO

TransverseMercatorTest is a part of GeographicLib, http://geographiclib.sf.net. The algorithms for the transverse Mercator projection are described in C. F. F. Karney, Transverse Mercator with an accuracy of a few nanometers, J. Geod (2011); DOI http://dx.doi.org/10.1007/s00190-011-0445-3; preprint http://arxiv.org/abs/1002.1417. The explanation of the domain of the projection with the -t option is given in Section 5 of this paper.


AUTHOR

TransverseMercatorTest was written by Charles Karney.