Provided by: geographiclib-tools_1.49-5_amd64

**NAME**

TransverseMercatorProj -- perform transverse Mercator projection

**SYNOPSIS**

TransverseMercatorProj[-s|-t] [-llon0] [-kk0] [-r] [-eaf] [-w] [-pprec] [--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 detils on the allowed formats for latitude and longitude, see the "GEOGRAPHIC COORDINATES" section ofGeoConvert(1). 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 grid north (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 the exact algorithm with the "EXTENDED DOMAIN".-llon0specify the longitude of originlon0(degrees, default 0).-kk0specify 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.-eafspecify the ellipsoid via the equatorial radius,aand the flattening,f. Settingf= 0 results in a sphere. Specifyf< 0 for a prolate ellipsoid. A simple fraction, e.g., 1/297, is allowed forf. By default, the WGS84 ellipsoid is used,a= 6378137 m,f= 1/298.257223563. If the exact algorithm is used,fmust be positive.-won input and output, longitude precedes latitude (except that on input this can be overridden by a hemisphere designator,N,S,E,W).-pprecset the output precision toprec(default 6).precis the number of digits after the decimal point for lengths (in meters). For latitudes and longitudes (in degrees), the number of digits after the decimal point isprec+ 5. For the convergence (in degrees) and scale, the number of digits after the decimal point isprec+ 6.--comment-delimitercommentdelimset 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-fileinfileread input from the fileinfileinstead of from standard input; a file name of "-" stands for standard input.--input-stringinstringread 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-separatorlinesepset the line separator character tolinesep. By default this is a semicolon.--output-fileoutfilewrite 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. Geodesy85(8), 475-485 (Aug. 2011); DOI <https://doi.org/10.1007/s00190-011-0445-3>; preprint <https://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, <https://geographiclib.sourceforge.io>, in 2009-01. Prior to version 1.9 it was called TransverseMercatorTest (and its interface was slightly different).