pygeodesy 24.6.24__py2.py3-none-any.whl → 24.7.24__py2.py3-none-any.whl

pygeodesy/cartesianBase.py

@@ -28,8 +28,8 @@ from pygeodesy.named import _name2__, _Pass
 from pygeodesy.namedTuples import LatLon4Tuple, _NamedTupleTo , Vector3Tuple, \
                                   Vector4Tuple,  Bearing2Tuple  # PYCHOK .sphericalBase
 # from pygeodesy.nvectorBase import _N_vector  # _MODS
-from pygeodesy.props import deprecated_method, Property, Property_RO, \
-                            property_doc_, property_RO, _update_all
+from pygeodesy.props import deprecated_method, Property, Property_RO, property_doc_, \
+                            property_RO, property_ROnce, _update_all
 # from pygeodesy,resections import cassini, collins5, pierlot, pierlotx, \
 #                                  tienstra7  # _MODS
 # from pygeodesy.streprs import Fmt  # from .fsums
@@ -43,7 +43,7 @@ from pygeodesy.vector3d import Vector3d, _xyzhdlln4
 # from math import atan2, degrees, fabs, radians, sqrt  # from .fmath, .utily
 
 __all__ = _ALL_LAZY.cartesianBase
-__version__ = '24.06.11'
+__version__ = '24.07.12'
 
 _r_     = 'r'
 _theta_ = 'theta'
@@ -211,12 +211,11 @@ class CartesianBase(Vector3d):
             r = Cartesian(*c, **kwds)
         return r.renamed(n) if n else r
 
-    @property_RO
+    @property_ROnce
     def Ecef(self):
         '''Get the ECEF I{class} (L{EcefKarney}), I{once}.
         '''
-        CartesianBase.Ecef = E = _MODS.ecef.EcefKarney  # overwrite property_RO
-        return E
+        return _MODS.ecef.EcefKarney
 
     @Property_RO
     def _ecef9(self):

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.06.15'
+__version__ = '24.07.02'
 
 if _unLazy0:
     from pygeodesy.deprecated import bases, datum, nvector, rhumbBase, \

pygeodesy/deprecated/classes.py

@@ -9,10 +9,10 @@ from pygeodesy.constants import NAN, _float
 from pygeodesy.interns import NN, _a12_, _area_, _band_, _convergence_, \
                              _distance_, _gamma_, _i_, _lat_, _lon_, _ltp_
 from pygeodesy.deprecated.consterns import _Deprecated_Str
-from pygeodesy.karney import _GTuple, Rhumb8Tuple as _Rhumb8Tuple
+from pygeodesy.karney import _GTuple, Rhumb8Tuple as _Rhumb8Tuple,  ADict
 from pygeodesy.lazily import _ALL_DEPRECATED, _ALL_DOCS, _ALL_MODS as _MODS
 from pygeodesy.ltpTuples import Ned4Tuple as _Ned4Tuple
-# from pygeodesy.named import _NamedTuple  # from .namedTuples
+# from pygeodesy.named import ADict, _NamedTuple  # from .karney, .namedTuples
 from pygeodesy.namedTuples import Forward4Tuple as _Forward4Tuple, \
                                   Reverse4Tuple as _Reverse4Tuple, \
                                   UtmUps5Tuple  as _UtmUps5Tuple,  _NamedTuple
@@ -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.06.15'
+__version__ = '24.07.02'
 
 
 class _Deprecated_NamedTuple(_NamedTuple):
@@ -264,6 +264,13 @@ class UtmUps4Tuple(_Deprecated_NamedTuple):  # PYCHOK no cover
     _Units_ = (_Deprecated_Str,) + _UtmUps5Tuple._Units_[1:4]
 
 
+class XDist(ADict):
+    '''DEPRECATED on 2024.07.02, use class L{XDict}.'''
+    def __init__(self, *args, **kwds):  # PYCHOK signature
+        deprecated_class(self.__class__)
+        ADict.__init__(self, *args, **kwds)
+
+
 __all__ += _ALL_DOCS(_Deprecated_NamedTuple)
 
 # **) MIT License

pygeodesy/ecef.py

@@ -76,7 +76,7 @@ from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS
 from pygeodesy.named import _name__, _name1__, _NamedBase, _NamedTuple, _Pass, _xnamed
 from pygeodesy.namedTuples import LatLon2Tuple, LatLon3Tuple, \
                                   PhiLam2Tuple, Vector3Tuple, Vector4Tuple
-from pygeodesy.props import deprecated_method, Property_RO, property_RO, property_doc_
+from pygeodesy.props import deprecated_method, Property_RO, property_ROver, property_doc_
 # from pygeodesy.streprs import Fmt, unstr  # from .fsums
 from pygeodesy.units import _isRadius, Degrees, Height, Int, Lam, Lat, Lon, Meter, \
                              Phi, Scalar, Scalar_
@@ -86,7 +86,7 @@ from pygeodesy.utily import atan1, atan1d, atan2d, degrees90, degrees180, \
 from math import atan2, cos, degrees, fabs, radians, sqrt
 
 __all__ = _ALL_LAZY.ecef
-__version__ = '24.06.11'
+__version__ = '24.06.12'
 
 _Ecef_    = 'Ecef'
 _prolate_ = 'prolate'
@@ -261,13 +261,12 @@ class _EcefBase(_NamedBase):
             raise EcefError(phi=phi, lam=lam, height=height, cause=x)
         return self._forward(*plhn, M=M, _philam=True)
 
-    @property_RO
+    @property_ROver
     def _Geocentrics(self):
         '''(INTERNAL) Get the valid geocentric classes. I{once}.
         '''
-        _EcefBase._Geocentrics = t = (Ecef9Tuple,    # overwrite property_RO
-                                     _MODS.cartesianBase.CartesianBase)
-        return t
+        return (Ecef9Tuple,  # overwrite property_ROver
+               _MODS.cartesianBase.CartesianBase)
 
     @Property_RO
     def _isYou(self):
@@ -1028,12 +1027,11 @@ class Ecef9Tuple(_NamedTuple):
     _Names_ = (_x_,   _y_,   _z_,   _lat_, _lon_, _height_, _C_,  _M_,   _datum_)
     _Units_ = ( Meter, Meter, Meter, Lat,   Lon,   Height,   Int, _Pass, _Pass)
 
-    @property_RO
+    @property_ROver
     def _CartesianBase(self):
         '''(INTERNAL) Get class C{CartesianBase}, I{once}.
         '''
-        Ecef9Tuple._CartesianBase = C = _MODS.cartesianBase.CartesianBase  # overwrite property_RO
-        return C
+        return _MODS.cartesianBase.CartesianBase  # overwrite property_ROver
 
     @deprecated_method
     def convertDatum(self, datum2):  # for backward compatibility

pygeodesy/ellipsoids.py

@@ -83,7 +83,7 @@ from pygeodesy.named import _lazyNamedEnumItem as _lazy, _name__, _NamedEnum, \
                                 _NamedEnumItem, _NamedTuple, _Pass,  _ALL_LAZY, _MODS
 from pygeodesy.namedTuples import Distance2Tuple, Vector3Tuple, Vector4Tuple
 from pygeodesy.props import deprecated_Property_RO, Property_RO, property_doc_, \
-                            deprecated_property_RO, property_RO
+                            deprecated_property_RO, property_RO, property_ROver
 from pygeodesy.streprs import Fmt, fstr, instr, strs, unstr
 # from pygeodesy.triaxials import _hartzell3  # _MODS
 from pygeodesy.units import Bearing_, Distance, Float, Float_, Height, Lamd, Lat, Meter, \
@@ -93,7 +93,7 @@ from pygeodesy.utily import atan1, atan1d, atan2b, degrees90, m2radians, radians
 from math import asinh, atan, atanh, cos, degrees, exp, fabs, radians, sin, sinh, sqrt, tan
 
 __all__ = _ALL_LAZY.ellipsoids
-__version__ = '24.06.24'
+__version__ = '24.07.16'
 
 _f_0_0    = Float(f =_0_0)  # zero flattening
 _f__0_0   = Float(f_=_0_0)  # zero inverse flattening
@@ -1029,17 +1029,18 @@ class Ellipsoid(_NamedEnumItem):
                 raise _ValueError(exact=g, ellipsoid=E, txt_not_=self.name)
         return g
 
-    @property_RO
+    @property_ROver
     def _Geodesics(self):
         '''(INTERNAL) Get all C{Geodesic...} classes, I{once}.
         '''
+        t = (_MODS.geodesicx.GeodesicExact,
+             _MODS.geodsolve.GeodesicSolve)
         try:
-            t = _MODS.geodesicw._wrapped.Geodesic,
+            t += (_MODS.geodesicw.Geodesic,
+                  _MODS.geodesicw._wrapped.Geodesic)
         except ImportError:
-            t = ()
-        Ellipsoid._Geodesics = t = (_MODS.geodesicx.GeodesicExact,  # overwrite property_RO
-                                    _MODS.geodsolve.GeodesicSolve) + t
-        return t
+            pass
+        return t  # overwrite propertyROver
 
     @property_RO
     def geodesicw(self):
@@ -1517,14 +1518,13 @@ class Ellipsoid(_NamedEnumItem):
         #     raise _IsnotError(_ellipsoidal_, ellipsoid=self)
         return _MODS.rhumb.ekx.Rhumb(self, name=self.name)
 
-    @property_RO
+    @property_ROver
     def _Rhumbs(self):
         '''(INTERNAL) Get all C{Rhumb...} classes, I{once}.
         '''
         p = _MODS.rhumb
-        Ellipsoid._Rhumbs = t = (p.aux_.RhumbAux,  # overwrite property_RO
-                                 p.ekx.Rhumb, p.solve.RhumbSolve)
-        return t
+        return (p.aux_.RhumbAux,  # overwrite propertyROver
+                p.ekx.Rhumb, p.solve.RhumbSolve)
 
     @property
     def rhumbsolve(self):

pygeodesy/errors.py

@@ -27,7 +27,7 @@ from pygeodesy.lazily import _ALL_LAZY, _ALL_MODS as _MODS, _getenv, _PYTHON_X_D
 from copy import copy as _copy
 
 __all__ = _ALL_LAZY.errors  # _ALL_DOCS('_InvalidError', '_IsnotError')  _under
-__version__ = '24.06.24'
+__version__ = '24.07.07'
 
 _argument_   = 'argument'
 _box_        = 'box'
@@ -827,6 +827,15 @@ def _xkwds_item2(kwds):
     raise _xAssertionError(_xkwds_item2, kwds)
 
 
+def _xkwds_kwds(kwds, **names_defaults):
+    '''(INTERNAL) Return a C{dict} of C{named_defaults} items replaced with C{kwds}.
+    '''
+    if not isinstance(kwds, dict):
+        raise _xAssertionError(_xkwds_get_, kwds)
+    _g = kwds.get
+    return dict((n, _g(n, v)) for n, v in names_defaults.items())
+
+
 def _xkwds_not(*args, **kwds):
     '''(INTERNAL) Return C{kwds} with a value not in C{args}.
     '''

pygeodesy/fsums.py

@@ -273,11 +273,17 @@ def _stresidual(prefix, residual, R=0, **mod_ratio):
 def _2sum(a, b):  # by .testFmath
     '''(INTERNAL) Return C{a + b} as 2-tuple (sum, residual).
     '''
+    # Neumaier, A. U{Rundungsfehleranalyse einiger Verfahren zur Summation endlicher
+    # Summen<https://OnlineLibrary.Wiley.com/doi/epdf/10.1002/zamm.19740540106>},
+    # 1974, Zeitschrift für Angewandte Mathmatik und Mechanik, vol 51, nr 1, p 39-51
+    # <https://StackOverflow.com/questions/78633770/can-neumaier-summation-be-sped-up>
     s = a + b
     if _isfinite(s):
         if fabs(a) < fabs(b):
-            b, a = a, b
-        return s, (b - (s - a))
+            r = (b - s) + a
+        else:
+            r = (a - s) + b
+        return s, r
     u = unstr(_2sum, a, b)
     t = Fmt.PARENSPACED(_not_finite_, s)
     raise _OverflowError(u, txt=t)
@@ -1909,10 +1915,10 @@ class Fsum(_Named):  # sync __methods__ with .vector3dBase.Vector3dBase
 
            @raise ResidualError: Invalid B{C{threshold}}.
 
-           @note: L{ResidualError}s may be thrown if the non-zero I{ratio}
-                  C{residual / fsum} exceeds the given B{C{threshold}} and
-                  if the C{residual} is non-zero and I{significant} vs the
-                  C{fsum}, i.e. C{(fsum + residual) != fsum} and if optional
+           @note: L{ResidualError}s may be thrown if (1) the non-zero I{ratio}
+                  C{residual / fsum} exceeds the given B{C{threshold}} and (2)
+                  the C{residual} is non-zero and (3) I{significant} vs the
+                  C{fsum}, i.e. C{(fsum + residual) != fsum} and (4) optional
                   keyword argument C{raiser=False} is missing.  Specify a
                   negative B{C{threshold}} for only non-zero C{residual}
                   testing without I{significant}.