TransverseMercatorTest -- convert between geographic and transverse Mercator
TransverseMercatorTest [ -r ] [ -s | -t ] [ --version | -h | --help ]
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.
perform the reverse projection; (the inputs are easting and northing).
use the sixth-order Krueger series approximation to the transverse Mercator projection instead of the exact projection.
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]
print version.
print usage.
print full documentation.
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
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.
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.
TransverseMercatorTest was written by Charles Karney.