Search:

TRANSVERSEMERCATORPROJ(1) GeographicLib Utilities TRANSVERSEMERCATORPROJ(1)## 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 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".-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. 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).-pset 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-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. Geodesy85(8), 475-485 (Aug. 2011); DOI <https://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). GeographicLib 1.45 2015-09-30 TRANSVERSEMERCATORPROJ(1)

Search: