Search:

GEODESICPROJ(1) GeographicLib Utilities GEODESICPROJ(1)## NAME

GeodesicProj -- perform projections based on geodesics## SYNOPSIS

GeodesicProj(-z|-c|-g)lat0lon0[-r] [-eaf] [-w] [-pprec] [--comment-delimitercommentdelim] [--version|-h|--help] [--input-fileinfile|--input-stringinstring] [--line-separatorlinesep] [--output-fileoutfile]## DESCRIPTION

Perform projections based on geodesics. Convert geodetic coordinates to either azimuthal equidistant, Cassini-Soldner, or gnomonic coordinates. The center of the projection (lat0,lon0) is specified by either the-coption (for Cassini-Soldner), the-zoption (for azimuthal equidistant), or the-goption (for gnomonic). At least one of these options must be given (the last one given 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 details on the allowed formats for latitude and longitude, see the "GEOGRAPHIC COORDINATES" section ofGeoConvert(1). For each set of geodetic coordinates, the corresponding projected coordinatesx,y(meters) are printed on standard output together with the azimuthazi(degrees) and reciprocal scalerk. For Cassini-Soldner,aziis the bearing of the easting direction and the scale in the easting direction is 1 and the scale in the northing direction is 1/rk. For azimuthal equidistant and gnomonic,aziis the bearing of the radial direction and the scale in the azimuthal direction is 1/rk. For azimuthal equidistant and gnomonic, the scales in the radial direction are 1 and 1/rk^2, respectively.## OPTIONS

-zuse the azimuthal equidistant projection centered at latitude =lat0, longitude =lon0. The-wflag can be used to swap the default order of the 2 coordinates, provided that it appears before-z.-cuse the Cassini-Soldner projection centered at latitude =lat0, longitude =lon0. The-wflag can be used to swap the default order of the 2 coordinates, provided that it appears before-c.-guse the ellipsoidal gnomonic projection centered at latitude =lat0, longitude =lon0. The-wflag can be used to swap the default order of the 2 coordinates, provided that it appears before-g.-rperform the reverse projection.xandyare given on standard input and each line of standard output giveslatitude,longitude,azi, andrk.-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.-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, longitudes, and azimuths (in degrees), the number of digits after the decimal point isprec+ 5. For the 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.## EXAMPLES

echo 48.648 -2.007 | GeodesicProj -c 48.836 2.337 => -319919 -11791 86.7 0.999 echo -319919 -11791 | GeodesicProj -c 48.836 2.337 -r => 48.648 -2.007 86.7 0.999## ERRORS

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

The ellipsoidal gnomonic projection is derived in Section 8 of C. F. F. Karney,Algorithmsforgeodesics, J. Geodesy 87, 43-55 (2013); DOI <https://dx.doi.org/10.1007/s00190-012-0578-z>; addenda: <http://geographiclib.sf.net/geod-addenda.html>.## AUTHOR

GeodesicProjwas written by Charles Karney.## HISTORY

GeodesicProjwas added to GeographicLib, <http://geographiclib.sf.net>, in 2009-08. Prior to version 1.9 it was called EquidistantTest. GeographicLib 1.45 2015-09-30 GEODESICPROJ(1)

Search: