pygeodesy 24.12.12__py2.py3-none-any.whl → 25.1.9__py2.py3-none-any.whl

pygeodesy/__init__.py

@@ -7,9 +7,9 @@ methods for geodetic (lat-/longitude), geocentric (U{ECEF<https://WikiPedia.org/
 cartesian) and certain U{triaxial ellipsoidal<https://GeographicLib.SourceForge.io/1.44/triaxial.html>}
 coordinates.
 
-Transcoded from U{JavaScript originals<https://GitHub.com/ChrisVeness/geodesy>} by I{Chris Veness (C) 2005-2024}
-and from several U{C++ classes<https://GeographicLib.SourceForge.io/C++/doc/annotated.html>} by I{Charles F. F.
-Karney (C) 2008-2024} and published under the same U{MIT License<https://OpenSource.org/licenses/MIT>}**.
+Transcoded in part from U{JavaScript originals<https://GitHub.com/ChrisVeness/geodesy>} by I{Chris Veness (C)
+2005-2024} and from several U{C++ classes<https://GeographicLib.SourceForge.io/C++/doc/annotated.html>} by I{Charles
+F. F. Karney (C) 2008-2024} and published under the same U{MIT License<https://OpenSource.org/licenses/MIT>}**.
 
 There are four modules for ellipsoidal earth models, C{ellipsoidalExact}, C{-Karney}, C{-Vincenty} and C{-Nvector}
 and two for spherical ones, C{sphericalTrigonometry} and C{-Nvector}.  Each module provides a geodetic B{C{LatLon}}
@@ -64,17 +64,17 @@ wiki/Hausdorff_distance>} distances.
 Installation
 ============
 
-To install PyGeodesy, type C{python[3] -m pip install PyGeodesy} or C{python[3] -m easy_install
-PyGeodesy} in a terminal or command window.
+To install PyGeodesy, type C{python[3] -m pip install pygeodesy} or C{python[3] -m easy_install
+pygeodesy} in a terminal or command window.
 
-If the wheel C{PyGeodesy-yy.m.d-py2.py3-none-any.whl} is missing in U{PyPI Download files<https://
-PyPI.org/project/PyGeodesy/#files>}, download the file from U{GitHub/dist<https://GitHub.com/mrJean1/
+If the wheel C{pygeodesy-yy.m.d-py2.py3-none-any.whl} is missing in U{PyPI Download files<https://
+PyPI.org/project/pygeodesy/#files>}, download the file from U{GitHub/dist<https://GitHub.com/mrJean1/
 PyGeodesy/tree/master/dist>}.  Install that with C{python[3] -m pip install <path-to-downloaded-wheel>}
 and verify with C{python[3] -m pygeodesy}.
 
-Alternatively, download C{PyGeodesy-yy.m.d.zip} from U{PyPI<https://PyPI.org/project/PyGeodesy>}
+Alternatively, download C{pygeodesy-yy.m.d.tar.gz} from U{PyPI<https://PyPI.org/project/pygeodesy>}
 or U{GitHub<https://GitHub.com/mrJean1/PyGeodesy>}, C{unzip} the downloaded file, C{cd} to
-directory C{Pygeodesy-yy.m.d} and type C{python[3] setup.py install}.
+directory C{pygeodesy-yy.m.d} and type C{python[3] setup.py install}.
 
 To run all PyGeodesy tests, type C{python[3] test/run.py} or type C{python[3] test/unitTestSuite.py}
 before or after installation.
@@ -113,16 +113,16 @@ env variable C{PYGEODESY_RHUMBSOLVE} or with property L{Ellipsoid.rhumbsolve}.
 Documentation
 =============
 
-In addition to the C{pygeodesy} package, the U{PyGeodesy<https://PyPI.org/project/PyGeodesy>}
+In addition to the C{pygeodesy} package, the U{PyGeodesy<https://PyPI.org/project/pygeodesy>}
 U{distribution files<https://GitHub.com/mrJean1/PyGeodesy/tree/master/dist>} contain the tests,
 the test results (on macOS only) and the complete U{documentation<https://mrJean1.GitHub.io/PyGeodesy>}
 (generated by U{Epydoc<https://PyPI.org/project/epydoc>} using command line:
-C{epydoc --html --no-private --no-source --name=PyGeodesy --url=... -v pygeodesy}).
+C{epydoc --html --no-private --no-source --name=pygeodesy --url=... -v pygeodesy}).
 
 Tests
 =====
 
-The tests ran with Python 3.13.0 (with U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0),
+The tests ran with Python 3.13.1 (with U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0),
 Python 3.12.7 (with U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0,
 U{numpy<https://PyPI.org/project/numpy>} 2.1.0, U{scipy<https://PyPI.org/project/scipy>} 1.14.1,
 U{GeodSolve<https://GeographicLib.SourceForge.io/C++/doc/utilities.html>} 2.3,
@@ -146,24 +146,24 @@ env variable C{PYGEODESY_WARNINGS=on} for all Python versions.  The results of t
 the distribution files.
 
 Test coverage has been measured with U{coverage<https://PyPI.org/project/coverage>} 7.6.1 using Python
-3.13.0, 3.12.7, 3.11.5 and 3.10.8.  The complete coverage report in HTML and a PDF summary are included in
+3.13.1, 3.12.7, 3.11.5 and 3.10.8.  The complete coverage report in HTML and a PDF summary are included in
 the distribution files.
 
-Python 3.13.0, 3.12.7, 3.11.5 and 3.10.8 run on Apple M1 Silicon (C{arm64}), I{natively}.  Python 2.7.18 runs
+Python 3.13.1, 3.12.7, 3.11.5 and 3.10.8 run on Apple M1 Silicon (C{arm64}), I{natively}.  Python 2.7.18 runs
 on Intel (C{x86_64}) or Intel I{emulation} ("C{arm64_x86_64}", see function L{machine<pygeodesy.machine>}).
 
-The tests also ran with Python 3.13.0 (and U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0) on
+The tests also ran with Python 3.13.1 (and U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0) on
 U{Debian 12<https://Cirrus-CI.com/github/mrJean1/PyGeodesy/master>} in 64-bit only, with Python 3.12.5 (and
-U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0) on U{Windows
-2019Server<https://CI.AppVeyor.com/project/mrJean1/pygeodesy>} in 64-bit only and with Python 2.7.18 (and
-U{geographiclib<https://PyPI.org/project/geographiclib>} 1.52) on U{Windows
-10<https://CI.AppVeyor.com/project/mrJean1/pygeodesy>} in 64- and 32-bit.
+U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0) on U{Windows 2019Server
+<https://CI.AppVeyor.com/project/mrJean1/pygeodesy>} in 64-bit only and with Python 2.7.18 (and U{geographiclib
+<https://PyPI.org/project/geographiclib>} 1.52) on U{Windows 10<https://CI.AppVeyor.com/project/mrJean1/pygeodesy>}
+in 64- and 32-bit.
 
 A single-File and single-Directory application with C{pygeodesy} has been bundled using U{PyInstaller
 <https://PyPI.org/project/pyinstaller>} 3.4 and 64-bit Python 3.7.3 on macOS 10.13.6 High Sierra.
 
-Previously, the tests were run with Python 3.12.0-6, 3.11.2-4, 3.10.1-7, 3.9.6, 3.9.1, 3.8.7, 3.7.1, 2.7.15, U{PyPy
-<https://PyPy.org>} 7.3.12 (Python 3.10.12), 7.3.1 (Python 3.6.9) and U{PyPy<https://PyPy.org>} 7.1.1 (Python
+Previously, the tests were run with Python 3.13.0, 3.12.0-6, 3.11.2-4, 3.10.1-7, 3.9.6, 3.9.1, 3.8.7, 3.7.1, 2.7.15,
+U{PyPy<https://PyPy.org>} 7.3.12 (Python 3.10.12), 7.3.1 (Python 3.6.9) and U{PyPy<https://PyPy.org>} 7.1.1 (Python
 2.7.13) (and U{geographiclib <https://PyPI.org/project/geographiclib>} 1.52, U{numpy<https://PyPI.org/project/numpy>}
 1.16.3, 1.16.4, 1.16.6, 1.19.0, 1.19.4, 1.19.5 or 1.22.4 and U{scipy<https://PyPI.org/project/scipy>} 1.2.1, 1.4.1,
 1.5.2 or 1.8.1) on U{Ubuntu 16.04<https://Travis-CI.com/mrJean1/PyGeodesy>}, with Python 3.10.0-1, 3.9.0-5, 3.8.0-6,
@@ -197,7 +197,7 @@ characters and if so, I{not} C{unicode}.
 Env variables
 =============
 
-The following environment variables are observed by C{PyGeodesy}:
+The following environment variables are observed by C{pygeodesy}:
 
  - C{PYGEODESY_EXCEPTION_CHAINING} - see module L{errors<pygeodesy.errors>}.
  - C{PYGEODESY_FMT_FORM} - see module L{dms<pygeodesy.dms>}.
@@ -355,7 +355,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.}
 
 @var pygeodesy_abspath: Fully qualified C{pygeodesy} directory name (C{str}).
 
-@var version: Normalized C{PyGeodesy} version (C{str}).
+@var version: Normalized C{pygeodesy} version (C{str}).
 '''
 
 import os.path as _os_path
@@ -566,7 +566,7 @@ if _init__all__ and not _lazy_import2:  # import and set __all__
         # GilderGeek<https://GitHub.com/mrJean1/PyGeodesy/issues/31>)
         ns = list(lazily._ALL_INIT)
 # XXX   ps = () if _isfrozen else set([_pygeodesy_] + __name__.split(_DOT_))
-        for mod, attrs in lazily._ALL_LAZY.enums():
+        for mod, attrs in lazily._all_enums():
             mod = _headof(_headof(mod))
             if mod not in globalocals:
                 t = _DOT_(_pygeodesy_, mod)
@@ -598,7 +598,7 @@ else:
 
 from pygeodesy.internals import _version2,  _DOT_  # PYCHOK import
 # from pygeodesy.interns import _DOT_  # from .internals
-__version__ = '24.12.12'
+__version__ = '25.01.09'
 # see setup.py for similar logic
 version     = _DOT_(*_version2(__version__, n=3))
 

pygeodesy/basics.py

@@ -37,7 +37,7 @@ from math import copysign as _copysign
 # import inspect as _inspect  # _MODS
 
 __all__ = _ALL_LAZY.basics
-__version__ = '24.11.02'
+__version__ = '24.12.31'
 
 _below_           = 'below'
 _list_tuple_types = (list, tuple)
@@ -362,25 +362,48 @@ def isint(obj, both=False):
     return False
 
 
-def isiterable(obj):
+def isiterable(obj, strict=False):
     '''Is B{C{obj}}ect C{iterable}?
 
        @arg obj: The object (any C{type}).
+       @kwarg strict: If C{True}, check class attributes (C{bool}).
 
        @return: C{True} if C{iterable}, C{False} otherwise.
     '''
     # <https://PyPI.org/project/isiterable/>
-    return hasattr(obj, '__iter__')  # map, range, set
+    return isiterabletype(obj) if strict else hasattr(obj, '__iter__')  # map, range, set
 
 
-def isiterablen(obj):
+def isiterablen(obj, strict=False):
     '''Is B{C{obj}}ect C{iterable} and has C{len}gth?
 
        @arg obj: The object (any C{type}).
+       @kwarg strict: If C{True}, check class attributes (C{bool}).
 
        @return: C{True} if C{iterable} with C{len}gth, C{False} otherwise.
     '''
-    return hasattr(obj, '__len__') and hasattr(obj, '__getitem__')
+    _has = isiterabletype if strict else hasattr
+    return _has(obj, '__len__') and _has(obj, '__getitem__')
+
+
+def isiterabletype(obj, method='__iter__'):
+    '''Is B{C{obj}}ect an instance of an C{iterable} class or type?
+
+       @arg obj: The object (any C{type}).
+       @kwarg method: The name of the required method (C{str}).
+
+       @return: The C{base-class} if C{iterable}, C{None} otherwise.
+    '''
+    try:  # <https://StackOverflow.com/questions/73568964>
+        for b in type(obj).__mro__[:-1]:  # ignore C{object}
+            try:
+                if callable(b.__dict__[method]):
+                    return b
+            except (AttributeError, KeyError):
+                pass
+    except (AttributeError, TypeError):
+        pass
+    return None
 
 
 try:
@@ -558,7 +581,7 @@ def map1(fun1, *xs):  # XXX map_
     return tuple(map(fun1, xs))
 
 
-def map2(fun, *xs):
+def map2(fun, *xs, **strict):
     '''Like Python's B{C{map}} but returning a C{tuple} of results.
 
        Unlike Python 2's built-in L{map}, Python 3+ L{map} returns a
@@ -568,10 +591,39 @@ def map2(fun, *xs):
 
        @arg fun: Function (C{callable}).
        @arg xs: Arguments (C{all positional}).
+       @kwarg strict: See U{Python 3.14+ map<https://docs.Python.org/
+                      3.14/library/functions.html#map>} (C{bool}).
 
        @return: Function results (C{tuple}).
     '''
-    return tuple(map(fun, *xs))
+    return tuple(map(fun, *xs, **strict) if strict else map(fun, *xs))
+
+
+def max2(*xs):
+    '''Return 2-tuple C{(max(xs), xs.index(max(xs)))}.
+    '''
+    return _max2min2(xs, max, max2)
+
+
+def _max2min2(xs, _m, _m2):
+    '''(INTERNAL) Helper for C{max2} and C{min2}.
+    '''
+    if len(xs) == 1:
+        x = xs[0]
+        if isiterable(x) or isiterablen(x):
+            x, i = _m2(*x)
+        else:
+            i = 0
+    else:
+        x = _m(xs)  # max or min
+        i =  xs.index(x)
+    return x, i
+
+
+def min2(*xs):
+    '''Return 2-tuple C{(min(xs), xs.index(min(xs)))}.
+    '''
+    return _max2min2(xs, min, min2)
 
 
 def neg(x, neg0=None):

pygeodesy/constants.py

@@ -26,7 +26,7 @@ except ImportError:  # Python 2-
     _inf, _nan = float(_INF_), float(_NAN_)
 
 __all__ = _ALL_LAZY.constants
-__version__ = '24.11.06'
+__version__ = '24.12.22'
 
 
 def _copysign_0_0(y):
@@ -182,6 +182,7 @@ _9_0     = _float(   9)       # PYCHOK expected
 _10_0    = _float(  10)       # PYCHOK expected
 _16_0    = _float(  16)       # PYCHOK expected
 _32_0    = _float(  32)       # PYCHOK expected
+_45_0    = _float(  45)       # PYCHOK expected
 _60_0    = _float(  60)       # PYCHOK expected
 _64_0    = _float(  64)       # PYCHOK expected
 _90_0    = _float(  90)       # PYCHOK expected
@@ -189,7 +190,6 @@ _100_0   = _float(_100_0)     # PYCHOK expected
 _180_0   = _float( 180)       # PYCHOK expected
 _270_0   = _float( 270)       # PYCHOK expected
 _360_0   = _float( 360)       # PYCHOK expected
-_400_0   = _float( 400)       # PYCHOK expected
 _720_0   = _float( 720)       # PYCHOK expected
 _1000_0  = _float(1000)       # PYCHOK expected
 _3600_0  = _float(3600)       # PYCHOK expected

pygeodesy/deprecated/__init__.py

@@ -27,7 +27,7 @@ __all__ = (_ALL_DEPRECATED.deprecated_bases +
            _ALL_DEPRECATED.deprecated_classes +
            _ALL_DEPRECATED.deprecated_consterns +
            _ALL_DEPRECATED.deprecated_functions)
-__version__ = '24.11.28'
+__version__ = '24.12.31'
 
 if _unLazy0:
     from pygeodesy.deprecated import bases, datum, nvector, rhumbBase, \

pygeodesy/deprecated/classes.py

@@ -22,7 +22,7 @@ from pygeodesy.trf import TRFXform7Tuple as _TRFXform7Tuple
 from pygeodesy.units import Bearing, Int, Lamd, Lat, Lon, Meter, Phid
 
 __all__ = _ALL_DEPRECATED.deprecated_classes
-__version__ = '24.11.07'
+__version__ = '24.12.31'
 
 
 class _Deprecated_NamedTuple(_NamedTuple):
@@ -111,6 +111,62 @@ def Fn_rt(root, *xs, **name_RESIDUAL_raiser):  # PYCHOK no cover
             Froot.__init__(self, root, *xs, **name_RESIDUAL_raiser)
 
 
+def FrechetCosineAndoyerLambert(point1s, **kwds):  # PYCHOK no cover
+    '''DEPRECATED on 2024.12.31, use class L{FrechetCosineLaw} with C{B{corr}=1}.'''
+    FrechetCosineLaw = _MODS.frechet.FrechetCosineLaw
+
+    class FrechetCosineAndoyerLambert(FrechetCosineLaw):
+        '''DEPRECATED on 2024.12.31, use class L{FrechetCosineLaw} with C{B{corr}=1}.
+        '''
+        def __init__(self, point1s, **seed_name__radius_wrap):
+            deprecated_class(self.__class__)
+            FrechetCosineLaw.__init__(self, point1s, corr=1, **seed_name__radius_wrap)
+
+    return FrechetCosineAndoyerLambert(point1s, **kwds)
+
+
+def FrechetCosineForsytheAndoyerLambert(point1s, **kwds):  # PYCHOK no cover
+    '''DEPRECATED on 2024.12.31, use class L{FrechetCosineLaw} with C{B{corr}=2}.'''
+    FrechetCosineLaw = _MODS.frechet.FrechetCosineLaw
+
+    class FrechetCosineForsytheAndoyerLambert(FrechetCosineLaw):
+        '''DEPRECATED on 2024.12.31, use class L{FrechetCosineLaw} with C{B{corr}=w}.
+        '''
+        def __init__(self, point1s, **seed_name__radius_wrap):
+            deprecated_class(self.__class__)
+            FrechetCosineLaw.__init__(self, point1s, corr=2, **seed_name__radius_wrap)
+
+    return FrechetCosineForsytheAndoyerLambert(point1s, **kwds)
+
+
+def HausdorffCosineAndoyerLambert(point1s, **kwds):  # PYCHOK no cover
+    '''DEPRECATED on 2024.12.31, use class L{HausdorffCosineLaw} with C{B{corr}=1}.'''
+    HausdorffCosineLaw = _MODS.hausdorff.HausdorffCosineLaw
+
+    class HausdorffCosineAndoyerLambert(HausdorffCosineLaw):
+        '''DEPRECATED on 2024.12.31, use class L{HausdorffCosineLaw} with C{B{corr}=1}.
+        '''
+        def __init__(self, point1s, **seed_name__radius_wrap):
+            deprecated_class(self.__class__)
+            HausdorffCosineLaw.__init__(self, point1s, corr=1, **seed_name__radius_wrap)
+
+    return HausdorffCosineAndoyerLambert(point1s, **kwds)
+
+
+def HausdorffCosineForsytheAndoyerLambert(point1s, **kwds):  # PYCHOK no cover
+    '''DEPRECATED on 2024.12.31, use class L{HausdorffCosineLaw} with C{B{corr}=2}.'''
+    HausdorffCosineLaw = _MODS.hausdorff.HausdorffCosineLaw
+
+    class HausdorffCosineForsytheAndoyerLambert(HausdorffCosineLaw):
+        '''DEPRECATED on 2024.12.31, use class L{HausdorffCosineLaw} with C{B{corr}=2}
+        '''
+        def __init__(self, point1s, **seed_name__radius_wrap):
+            deprecated_class(self.__class__)
+            HausdorffCosineLaw.__init__(self, point1s, corr=2, **seed_name__radius_wrap)
+
+    return HausdorffCosineForsytheAndoyerLambert(point1s, **kwds)
+
+
 def HeightIDW(knots, **kwds):  # PYCHOK no cover
     '''DEPRECATED, use class L{HeightIDWeuclidean}.'''
     HeightIDWeuclidean = _MODS.heights.HeightIDWeuclidean
@@ -151,6 +207,34 @@ def HeightIDW3(knots, **kwds):  # PYCHOK no cover
     return HeightIDW3(knots, **kwds)
 
 
+def HeightIDWcosineAndoyerLambert(knots, **kwds):  # PYCHOK no cover
+    '''DEPRECATED on 2024.12.31, use class L{HeightIDWcosineLaw} with C{B{corr}=1}.'''
+    HeightIDWcosineLaw = _MODS.heights.HeightIDWcosineLaw
+
+    class HeightIDWcosineAndoyerLambert(HeightIDWcosineLaw):
+        '''DEPRECATED on 2024.12.31, use class L{HeightIDWcosineLaw} with C{B{corr}=1}.
+        '''
+        def __init__(self, knots, **beta_name__datum_wrap):
+            deprecated_class(self.__class__)
+            HeightIDWcosineLaw.__init__(self, knots, corr=1, **beta_name__datum_wrap)
+
+    return HeightIDWcosineAndoyerLambert(knots, **kwds)
+
+
+def HeightIDWcosineForsytheAndoyerLambert(knots, **kwds):  # PYCHOK no cover
+    '''DEPRECATED on 2024.12.31, use class L{HeightIDWcosineLaw} with C{B{corr}=2}.'''
+    HeightIDWcosineLaw = _MODS.heights.HeightIDWcosineLaw
+
+    class HeightIDWcosineForsytheAndoyerLambert(HeightIDWcosineLaw):
+        '''DEPRECATED on 2024.12.31, use class L{HeightIDWcosineLaw} with C{B{corr}=2}.
+        '''
+        def __init__(self, knots, **beta_name__datum_wrap):
+            deprecated_class(self.__class__)
+            HeightIDWcosineLaw.__init__(self, knots, corr=2, **beta_name__datum_wrap)
+
+    return HeightIDWcosineForsytheAndoyerLambert(knots, **kwds)
+
+
 class Lam_(Lamd):
     '''DEPRECATED on 2024.06.15, use class L{Lamd}.'''
     def __init__(self, *args, **kwds):  # PYCHOK no cover

pygeodesy/deprecated/datum.py

@@ -11,11 +11,11 @@ from pygeodesy.ellipsoids import Ellipsoid, Ellipsoids, Curvature2Tuple
 from pygeodesy.lazily import _ALL_DEPRECATED, _ALL_OTHER
 
 __all__ = _ALL_DEPRECATED.deprecated_datum
-__version__ = '24.06.15'
+__version__ = '24.12.31'
 
-assert _ALL_OTHER(Curvature2Tuple, Datum,  Ellipsoid,  Transform) + \
-            tuple(_.name for _ in (Datums, Ellipsoids, Transforms,
-                    R_FM, R_KM, R_M, R_MA, R_MB, R_NM, R_SM, R_VM)) == __all__
+assert _ALL_OTHER(Curvature2Tuple, Datum,  Ellipsoid,  Transform) + tuple(_.name for _ in
+                                  (Datums, Ellipsoids, Transforms,
+                                   R_FM, R_KM, R_M, R_MA, R_MB, R_NM, R_SM, R_VM)) == __all__
 
 # **) MIT License
 #

pygeodesy/deprecated/functions.py

@@ -14,7 +14,7 @@ from pygeodesy.props import deprecated_function
 from pygeodesy.units import _1mm, Number_, Scalar_
 
 __all__ = _ALL_DEPRECATED.deprecated_functions
-__version__ = '24.11.28'
+__version__ = '24.12.31'
 
 _WGS84 = _UTM = object()
 
@@ -84,6 +84,30 @@ def copysign(x, y):  # PYCHOK no cover
     return _MODS.basics.copysign0(x, y)
 
 
+@deprecated_function
+def cosineAndoyerLambert(lat1, lon1, lat2, lon2, **datum_wrap):
+    '''DEPRECATED on 2024.12.31, use function L{pygeodesy.cosineLaw} with C{B{corr}=1}.'''
+    return _MODS.formy.cosineLaw(lat1, lon1, lat2, lon2, corr=1, **datum_wrap)
+
+
+@deprecated_function
+def cosineAndoyerLambert_(phi2, phi1, lam21, **datum):
+    '''DEPRECATED on 2024.12.31, use function L{pygeodesy.cosineLaw_} with C{B{corr}=1}.'''
+    return _MODS.formy.cosineLaw_(phi2, phi1, lam21, corr=1, **datum)
+
+
+@deprecated_function
+def cosineForsytheAndoyerLambert(lat1, lon1, lat2, lon2, **datum_wrap):
+    '''DEPRECATED on 2024.12.31, use function L{pygeodesy.cosineLaw} with C{B{corr}=2}.'''
+    return _MODS.formy.cosineLaw(lat1, lon1, lat2, lon2, corr=2, **datum_wrap)
+
+
+@deprecated_function
+def cosineForsytheAndoyerLambert_(phi2, phi1, lam21, **datum):
+    '''DEPRECATED on 2024.12.31, use function L{pygeodesy.cosineLaw_} with C{B{corr}=2}.'''
+    return _MODS.formy.cosineLaw_(phi2, phi1, lam21, corr=2, **datum)
+
+
 @deprecated_function
 def decodeEPSG2(arg):  # PYCHOK no cover
     '''DEPRECATED, use function L{epsg.decode2}.

pygeodesy/ecef.py

@@ -1102,12 +1102,12 @@ class Ecef9Tuple(_NamedTuple, _NamedLocal):
         '''
         return Lon(Vermeille=degrees(self.lamVermeille))
 
-    def _ltp_toLocal(self, ltp, Cls_and_kwds, **nam_Cls):  # for C{_NamedLocal}
+    def _ltp_toLocal(self, ltp, Xyz_kwds, **Xyz):  # overloads C{_NamedLocal}'s
         '''(INTERNAL) Invoke C{ltp._xLtp(ltp)._ecef2local}.
         '''
-        Cls, kwds = self._ltp_toLocal2(Cls_and_kwds, **nam_Cls)  # in ._NamedLocal
-        ltp = self._ltp._xLtp(ltp, self._Ltp)  # both in ._NamedLocal
-        return ltp._ecef2local(self, Cls, kwds)
+        Xyz_ = self._ltp_toLocal2(Xyz_kwds, **Xyz)  # in ._NamedLocal
+        ltp  = self._ltp._xLtp(ltp, self._Ltp)  # both in ._NamedLocal
+        return ltp._ecef2local(self, *Xyz_)
 
     @Property_RO
     def phi(self):

pygeodesy/fmath.py

@@ -23,7 +23,7 @@ from math import fabs, sqrt  # pow
 import operator as _operator  # in .datums, .trf, .utm
 
 __all__ = _ALL_LAZY.fmath
-__version__ = '24.12.02'
+__version__ = '25.01.09'
 
 # sqrt(2) - 1 <https://WikiPedia.org/wiki/Square_root_of_2>
 _0_4142  =  0.41421356237309504880  # ... ~ 3730904090310553 / 9007199254740992
@@ -834,7 +834,7 @@ if _MODS.sys_version_info2 < (3, 8):  # PYCHOK no cover
         '''
         return float(_Hypot(*xs))
 
-elif _MODS.sys_version_info2 < (3, 10):
+elif _MODS.sys_version_info2 < (3, 10):  # PYCHOK no cover
     # In Python 3.8 and 3.9 C{math.hypot} is inaccurate, see
     # U{agdhruv<https://GitHub.com/geopy/geopy/issues/466>},
     # U{cffk<https://Bugs.Python.org/issue43088>} and module
@@ -981,7 +981,7 @@ def _root(x, p, where):
             raise ValueError(_negative_)
     except Exception as X:
         raise _xError(X, unstr(where, x))
-    return _0_0
+    return _0_0 if p else _1_0
 
 
 def sqrt0(x, Error=None):