aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorCharles Karney <charles@karney.com>2015-08-16 15:05:36 -0400
committerCharles Karney <charles@karney.com>2015-08-16 15:05:36 -0400
commit8066dcd0e9ce33222b167dbb2a8ddab79465d299 (patch)
tree617a14fc6f9e8301a75b8cb805d50b50c7948146 /man
parent6c16367e152747133bba7a8fbcdbabef1232cd93 (diff)
downloadPROJ-8066dcd0e9ce33222b167dbb2a8ddab79465d299.tar.gz
PROJ-8066dcd0e9ce33222b167dbb2a8ddab79465d299.zip
Drop in the latest geodesic library from GeographicLib (version 1.44).
http://geographiclib.sourceforge.net/1.44/C/index.html The changes are: - Improve accuracy of calculations by evaluating trigonometric functions more carefully and replacing the series for the reduced length with one with a smaller truncation error. - The allowed ranges for longitudes and azimuths is now unlimited; it used to be [-540d, 540d). - Enforce the restriction of latitude to [-90d, 90d] by returning NaNs if the latitude is outside this range. - The inverse calculation sets s12 to zero for coincident points at pole (instead of returning a tiny quantity). This commit also includes a work-around for an inaccurate value for pi/180 in dmstor.c (see the definitions of DEG_IN and DEG_OUT in geod_interface.c).
Diffstat (limited to 'man')
-rw-r--r--man/man1/geod.123
-rw-r--r--man/man3/geodesic.36
2 files changed, 17 insertions, 12 deletions
diff --git a/man/man1/geod.1 b/man/man1/geod.1
index 81a12e14..157996e6 100644
--- a/man/man1/geod.1
+++ b/man/man1/geod.1
@@ -30,16 +30,22 @@ file[s]
]
file[s]
.SH DESCRIPTION
-.I Geod
+.I geod
(direct) and
.I invgeod
(inverse)
-perform geodesic (\*(lqGreat Circle\*(rq) computations for determining
+perform geodesic ("Great Circle") computations for determining
latitude, longitude and back azimuth of a terminus point
given a initial point latitude, longitude, azimuth and distance (direct) or
the forward and back azimuths and distance between an initial and
terminus point latitudes and longitudes (inverse). The results are
accurate to round off for |\fIf\fR| < 1/50, where \fIf\fR is flattening.
+.B invgeod
+may not be available on all platforms; in this case call
+.B geod
+with the
+.B \-I
+option.
.PP
The following command-line options can appear in any order:
.TP
@@ -120,12 +126,11 @@ input for the inverse mode and respective forward and back
azimuth from the initial and terminus points are output along
with the distance between the points.
.PP
-Input geographic coordinates
-(latitude and longitude) and azimuthal data must be in DMS format and input
-distance data must be in units consistent with the ellipsoid
-major axis or sphere radius units.
-Output geographic coordinates will be in DMS
-(if the
+Input geographic coordinates (latitude and longitude) and azimuthal data
+must be in decimal degrees or DMS format and input distance data must be
+in units consistent with the ellipsoid major axis or sphere radius
+units. The latitude must lie in the range [-90d,90d]. Output
+geographic coordinates will be in DMS (if the
.B \-f
switch is not employed) to 0.001"
with trailing, zero-valued minute-second fields deleted.
@@ -220,4 +225,4 @@ The \fIonline geodesic bibliography\fR,
.br
http://geographiclib.sf.net/geodesic-papers/biblio.html
.SH HOME PAGE
-http://proj.osgeo.org
+https://github.com/OSGeo/proj.4/wiki
diff --git a/man/man3/geodesic.3 b/man/man3/geodesic.3
index ece2d4d9..bf0d764d 100644
--- a/man/man3/geodesic.3
+++ b/man/man3/geodesic.3
@@ -38,7 +38,7 @@ measure angles (latitudes, longitudes, and azimuths) in degrees, unlike
the rest of the \fBproj\fR library, which uses radians. The
documentation for this library is included in geodesic.h. A formatted
version of the documentation is available at
-http://geographiclib.sf.net/1.43/C
+http://geographiclib.sf.net/1.44/C
.SH EXAMPLE
The following program reads in lines with the coordinates for two points
in decimal degrees (\fIlat1\fR, \fIlon1\fR, \fIlat2\fR, \fIlon2\fR) and
@@ -72,7 +72,7 @@ libproj.a \- library of projections and support procedures
.SH SEE ALSO
Full online documentation for \fBgeodesic(3)\fR,
.br
-http://geographiclib.sf.net/1.43/C
+http://geographiclib.sf.net/1.44/C
.PP
.B geod(1)
.PP
@@ -94,4 +94,4 @@ The \fIonline geodesic bibliography\fR,
.br
http://geographiclib.sf.net/geodesic-papers/biblio.html
.SH HOME PAGE
-http://proj.osgeo.org
+https://github.com/OSGeo/proj.4/wiki