/usr/share/doc/geographiclib/html/intro.html is in geographiclib-doc 1.45-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.9.1"/>
<title>GeographicLib: Introduction</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
extensions: ["tex2jax.js"],
jax: ["input/TeX","output/HTML-CSS"],
});
</script><script src="/usr/share/javascript/mathjax/MathJax.js/MathJax.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">GeographicLib
 <span id="projectnumber">1.45</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.9.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">Introduction </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><center> Forward to <a class="el" href="install.html">Installing GeographicLib</a>. Up to <a class="el" href="index.html#contents">Contents</a>. </center><p><a class="el" href="namespaceGeographicLib.html" title="Namespace for GeographicLib. ">GeographicLib</a> offers a C++ interfaces to a small (but important!) set of geographic transformations. It grew out of a desire to improve on the <a href="http://earth-info.nima.mil/GandG/geotrans/">geotrans</a> package for transforming between geographic and <a class="el" href="classGeographicLib_1_1MGRS.html" title="Convert between UTM/UPS and MGRS. ">MGRS</a> coordinates. At present, <a class="el" href="namespaceGeographicLib.html" title="Namespace for GeographicLib. ">GeographicLib</a> provides UTM, UPS, <a class="el" href="classGeographicLib_1_1MGRS.html" title="Convert between UTM/UPS and MGRS. ">MGRS</a>, geocentric, and local cartesian projections, gravity and geomagnetic models, and classes for geodesic calculations.</p>
<p>The goals of <a class="el" href="namespaceGeographicLib.html" title="Namespace for GeographicLib. ">GeographicLib</a> are:</p><ul>
<li>Accuracy. In most applications the accuracy is close to round-off, about 5 nm (5 nanometers). Even though in many geographic applications 1 cm is considered "accurate enough", there is little penalty in providing much better accuracy. In situations where a faster approximate algorithm is necessary, <a class="el" href="namespaceGeographicLib.html" title="Namespace for GeographicLib. ">GeographicLib</a> offers an accurate benchmark to guide the development.</li>
<li>Completeness. For each of the projections included, an attempt is made to provide a complete solution. For example, <a class="el" href="classGeographicLib_1_1Geodesic.html#ad7e59a242125a35a95c96cdb20573081">Geodesic::Inverse</a> works for anti-podal points. Similarly, <a class="el" href="classGeographicLib_1_1Geocentric.html#a1907735ce8f5f915a14a5f7a8b3adfea">Geocentric.Reverse</a> will return accurate geodetic coordinates even for points close to the center of the earth.</li>
<li>C++ interface. For the projection methods, this allows encapsulation of the ellipsoid parameters.</li>
<li>Emphasis on projections necessary for analyzing military data.</li>
<li>Uniform treatment of UTM/UPS. The <a class="el" href="classGeographicLib_1_1UTMUPS.html" title="Convert between geographic coordinates and UTM/UPS. ">UTMUPS</a> class treats UPS as zone 0. This simplifies conversions between UTM and UPS coordinates, etc.</li>
<li>Well defined and stable conventions for the conversion between UTM/UPS to <a class="el" href="classGeographicLib_1_1MGRS.html" title="Convert between UTM/UPS and MGRS. ">MGRS</a> coordinates.</li>
<li>Detailed internal documentation on the algorithms. For the most part <a class="el" href="namespaceGeographicLib.html" title="Namespace for GeographicLib. ">GeographicLib</a> uses published algorithms and references are given. If changes have been made (usually to improve the numerical accuracy), these are described in the code.</li>
</ul>
<p>Various <a class="el" href="utilities.html">Utility programs</a> are provided with the library. These illustrate the use of the library and are useful in their own right. This library and the utilities have been tested with g++ 4.4 under Linux, with g++ 4.2 under Mac OS X, and with MS Visual Studio 9 (2008), 10 (2010), 11 (2012), and 12 (2013) compiled for 32 bit and 64 bit.</p>
<p>MATLAB, JavaScript, and Python interfaces are provided to portions of <a class="el" href="namespaceGeographicLib.html" title="Namespace for GeographicLib. ">GeographicLib</a>; see <a class="el" href="other.html">Implementations in other languages</a>.</p>
<p>The section <a class="el" href="geodesic.html">Geodesics on an ellipsoid of revolution</a> documents the method of solving the geodesic problem.</p>
<p>The section <a class="el" href="transversemercator.html">Transverse Mercator projection</a> documents various properties of this projection.</p>
<p>The bulk of the testing has used geographically relevant values of the flattening. Thus, you can expect close to full accuracy for −0.01 ≤ <em>f</em> ≤ 0.01 (but note that <a class="el" href="classGeographicLib_1_1TransverseMercatorExact.html" title="An exact implementation of the transverse Mercator projection. ">TransverseMercatorExact</a> is restricted to <em>f</em> > 0). However, reasonably accurate results can be expected if −0.1 ≤ <em>f</em> ≤ 0.1. Outside this range, you should attempt to verify the accuracy of the routines independently. Two types of problems may occur with larger values of <em>f</em>:</p><ul>
<li>Some classes, specifically <a class="el" href="classGeographicLib_1_1Geodesic.html" title="Geodesic calculations ">Geodesic</a>, <a class="el" href="classGeographicLib_1_1GeodesicLine.html" title="A geodesic line. ">GeodesicLine</a>, and <a class="el" href="classGeographicLib_1_1TransverseMercator.html" title="Transverse Mercator projection. ">TransverseMercator</a>, use series expansions using <em>f</em> as a small parameter. The accuracy of these routines will degrade as <em>f</em> becomes large.</li>
<li>Even when exact formulas are used, many of the classes need to invert the exact formulas (e.g., to invert a projection), typically, using Newton's method. This usually provides an essentially exact inversion. However, the choice of starting guess and the exit conditions have been tuned to cover small values of <em>f</em> and the inversion may be incorrect if <em>f</em> is large.</li>
</ul>
<p>Undoubtedly, bugs lurk in this code and in the documentation. Please report any you find to <a href="#" onclick="location.href='mai'+'lto:'+'cha'+'rl'+'es@'+'ka'+'rne'+'y.'+'com'; return false;">charl<span style="display: none;">.nosp@m.</span>es@k<span style="display: none;">.nosp@m.</span>arney<span style="display: none;">.nosp@m.</span>.com</a>.</p>
<center> Forward to <a class="el" href="install.html">Installing GeographicLib</a>. Up to <a class="el" href="index.html#contents">Contents</a>. </center> </div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.9.1
</small></address>
</body>
</html>
|