pygeodesy 24.3.24__py2.py3-none-any.whl

pygeodesy/geodesicx/__init__.py

@@ -0,0 +1,48 @@
+
+# -*- coding: utf-8 -*-
+
+u'''A pure Python version of I{Karney}'s C++ classes U{GeodesicExact
+<https://GeographicLib.SourceForge.io/C++/classGeographicLib_1_1GeodesicExact.html>}
+and U{GeodesicLineExact
+<https://geographiclib.sourceforge.io/C++/doc/classGeographicLib_1_1GeodesicLine.html>}.
+
+For more details, see the C++ U{GeographicLib<https://GeographicLib.SourceForge.io/C++/doc/index.html>}
+documentation, especially the U{Class List<https://GeographicLib.SourceForge.io/C++/doc/annotated.html>}
+and the background information at U{Geodesics on an ellipsoid of revolution
+<https://GeographicLib.SourceForge.io/C++/doc/geodesic.html#geodseries>}.
+
+Also, compare C{GeodesicExact} and C{GeodesicLineExact} to I{standard} classes C{Geodesic}
+respectively C{GeodesicLine} from I{Karney}'s Python implementation U{geographiclib
+<https://GeographicLib.SourceForge.io/C++/doc/other.html#python>}, see module
+L{pygeodesy.karney}.
+'''
+
+from pygeodesy.geodesicx.gx import GeodesicExact, GeodesicLineExact  # PYCHOK exported
+from pygeodesy.geodesicx.gxarea import GeodesicAreaExact, PolygonArea  # PYCHOK exported
+from pygeodesy.karney import Caps, GeodesicError
+from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY
+
+__all__ = _ALL_LAZY.geodesicx + _ALL_DOCS(Caps, GeodesicError)
+__version__ = '23.12.03'
+
+# **) MIT License
+#
+# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.

pygeodesy/geodesicx/__main__.py

@@ -0,0 +1,91 @@
+
+# -*- coding: utf-8 -*-
+
+u'''Print L{geodesicx} version, etc. using C{python -m pygeodesy.geodesicx}.
+'''
+
+__all__ = ()
+__version__ = '23.06.19'
+
+
+def _C4stats(nC4=None):  # PYCHOK no cover
+    '''(INTERNAL) Get the C{C4} stats.
+    '''
+    from pygeodesy import GeodesicExact, geodesicx
+
+    gX = GeodesicExact(C4order=nC4)
+    cs = geodesicx.gx._C4coeffs(gX.C4order)
+    ss = set(cs)  # without duplicates
+    pc = '%.1f%%' % (len(ss) * 100.0 / len(cs))
+    cx = gX._C4x
+    return dict(C4order=gX.C4order, C4len=len(cs), C4set=len(ss), C4set_len=pc, C4x=len(cx))
+
+
+def _main():  # PYCHOK no cover
+
+    import os.path as os_path
+
+    try:
+        from pygeodesy import geodesicx as _gx, GeodesicError, \
+                              GeodesicSolve, printf, pygeodesy_abspath
+        from pygeodesy.interns import _COMMASPACE_, _DOT_, _pythonarchine, \
+                                      _SPACE_, _usage, _version_
+        from pygeodesy.streprs import Fmt
+
+        def _dot_attr(name, value):
+            return Fmt.DOT(Fmt.EQUAL(name, value))
+
+        s = tuple(sorted(_C4stats().items()))
+        p = [_dot_attr(*t) for t in (((_version_, _gx.__version__),) + s)]
+
+        def _name_version(pkg):
+            return _SPACE_(pkg.__name__, pkg.__version__)
+
+        v = _pythonarchine()
+        try:
+            import geographiclib
+            v.append(_name_version(geographiclib))
+        except ImportError:
+            pass
+        try:
+            g = GeodesicSolve()
+            v.append(g.version)
+        except GeodesicError:
+            pass
+
+        g = _gx.__name__
+        x =  os_path.basename(pygeodesy_abspath)
+        if not g.startswith(x):
+            g = _DOT_(x, g)
+        printf('%s%s (%s)', g, _COMMASPACE_.join(p), _COMMASPACE_.join(v))
+
+    except ImportError:
+        printf(_usage(__file__))
+
+
+_main()
+
+# **) MIT License
+#
+# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+
+# % python3 -m pygeodesy.geodesicx
+# pygeodesy.geodesicx.version=21.05.30, .C4Order=None, .C4len=5425, .C4set=5107, .C4set100=94, .C4x=465 (Python 3.9.5, 64bit, geographiclib 1.52)