Provided by: geographiclib-tools_1.21-1ubuntu1_amd64

**NAME**

TransverseMercatorProj -- perform transverse Mercator projection

**SYNOPSIS**

TransverseMercatorProj[-s|-t] [-llon0] [-kk1] [-r] [-eaf] [--comment-delimitercommentdelim] [--version|-h|--help] [--input-fileinfile|--input-stringinstring] [--line-separatorlinesep] [--output-fileoutfile]

**DESCRIPTION**

Perform the transverse Mercator projections. Convert geodetic coordinates to transverse Mercator coordinates. The central meridian is given bylon0. The longitude of origin is the equator. The scale on the central meridian isk0. By default an implementation of the exact transverse Mercator projection is used. Geodetic coordinates are provided on standard input as a set of lines containing (blank separated)latitudeandlongitude(decimal degrees or degrees, minutes, seconds). For each set of geodetic coordinates, the corresponding projected easting,x, and northing,y, (meters) are printed on standard output together with the meridian convergencegamma(degrees) and scalek. The meridian convergence is the bearing of theyaxis measured clockwise from true north.

**OPTIONS**

-suse the sixth-order Krueger series approximation to the transverse Mercator projection instead of the exact projection.-tuse exact algorithm with the EXTENDED DOMAIN.-lspecify the longitude of originlon0(degrees, default 0).-kspecify the scalek0on the central meridian (default 0.9996).-rperform the reverse projection.xandyare given on standard input and each line of standard output giveslatitude,longitude,gamma, andk.-especify the ellipsoid viaaf; the equatorial radius isaand the flattening isf. Settingf= 0 results in a sphere. Specifyf< 0 for a prolate ellipsoid. A simple fraction, e.g., 1/297, is allowed forf. (Also, iff> 1, the flattening is set to 1/f.) By default, the WGS84 ellipsoid is used,a= 6378137 m,f= 1/298.257223563. If the exact algorithm is used,fmust be positive.--comment-delimiterset the comment delimiter tocommentdelim(e.g., "#" or "//"). If set, the input lines will be scanned for this delimiter and, if found, the delimiter and the rest of the line will be removed prior to processing and subsequently appended to the output line (separated by a space).--versionprint version and exit.-hprint usage and exit.--helpprint full documentation and exit.--input-fileread input from the fileinfileinstead of from standard input; a file name of "-" stands for standard input.--input-stringread input from the stringinstringinstead of from standard input. All occurrences of the line separator character (default is a semicolon) ininstringare converted to newlines before the reading begins.--line-separatorset the line separator character tolinesep. By default this is a semicolon.--output-filewrite output to the fileoutfileinstead of to standard output; a file name of "-" stands for standard output.

**EXTENDED** **DOMAIN**

The exact transverse Mercator projection has abranchpointon the equator at longitudes (relative tolon0) of +/- (1 -e) 90, whereeis the eccentricity of the ellipsoid. The standard convention for handling this branch point is to map positive (negative) latitudes into positive (negative) northingsy; i.e., a branch cut is placed on the equator. With theextendeddomain, the northern sheet of the projection is extended into the south hemisphere by pushing the branch cut south from the branch points. See the reference below for details.

**EXAMPLES**

echo 0 90 | TransverseMercatorProj => 25953592.84 9997964.94 90 18.40 echo 260e5 100e5 | TransverseMercatorProj -r => -0.02 90.00 90.01 18.48

**ERRORS**

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

**AUTHOR**

TransverseMercatorProjwas written by Charles Karney.

**SEE** **ALSO**

The algorithms for the transverse Mercator projection are described in C. F. F. Karney,TransverseMercatorwithanaccuracyofafewnanometers, J. Geod85(8), 475-485 (Aug. 2011); DOI http://dx.doi.org/10.1007/s00190-011-0445-3 <http://dx.doi.org/10.1007/s00190-011-0445-3>; preprint <http://arxiv.org/abs/1002.1417>. The explanation of the extended domain of the projection with the-toption is given in Section 5 of this paper.

**HISTORY**

TransverseMercatorProjwas added to GeographicLib, <http://geographiclib.sf.net>, in 2009-01. Prior to version 1.9 it was called TransverseMercatorTest (and its interface was slightly different).