pygeodesy 25.4.25__py2.py3-none-any.whl → 25.5.25__py2.py3-none-any.whl

pygeodesy/named.py

@@ -28,16 +28,14 @@ from pygeodesy.interns import MISSING, NN, _AT_, _COLON_, _COLONSPACE_, _COMMA_,
                              _EQUAL_, _exists_, _immutable_, _name_, _NL_, _NN_, \
                              _no_, _other_, _s_, _SPACE_, _std_, _UNDER_, _vs_
 from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS
-# from pygeodesy.ltp import Ltp, _toLocal, _toLtp  # _MODS
-# from pygeodesy.ltpTuples import Aer, Enu, Ned  # _MODS
 from pygeodesy.props import _allPropertiesOf_n, deprecated_method, _hasProperty, \
                             _update_all, property_doc_, Property_RO, property_RO, \
-                            _update_attrs, property_ROver
+                            _update_attrs
 from pygeodesy.streprs import attrs, Fmt, lrstrip, pairs, reprs, unstr
 # from pygeodesy.units import _toUnit  # _MODS
 
 __all__ = _ALL_LAZY.named
-__version__ = '25.04.14'
+__version__ = '25.04.28'
 
 _COMMANL_           = _COMMA_ + _NL_
 _COMMASPACEDOT_     = _COMMASPACE_ + _DOT_
@@ -915,148 +913,6 @@ class _NamedEnumItem(_NamedBase):
                 raise _AssertionError(t)
 
 
-class _NamedLocal(object):
-    '''(INTERNAL) Base class for C{CartesianBase}, C{Ecef9Tuple} and C{LatLonBase}.
-     '''
-
-    @property_ROver
-    def Ecef(self):
-        '''Get the ECEF I{class} (L{EcefKarney}), I{once}.
-        '''
-        return _MODS.ecef.EcefKarney
-
-    @property_RO
-    def _ecef9(self):
-        '''I{Must be overloaded}.'''
-        notOverloaded(self)
-
-    @Property_RO
-    def _Ltp(self):
-        '''(INTERNAL) Cache this instance' LTP (L{Ltp}).
-        '''
-        return self._ltp.Ltp(self._ecef9, ecef=self.Ecef(self.datum), name=self.name)
-
-    @property_ROver
-    def _ltp(self):
-        '''(INTERNAL) Get module L{pygeodesy.ltp}, I{once}.
-        '''
-        return _MODS.ltp
-
-    def _ltp_toLocal(self, ltp, Xyz_kwds, **Xyz):  # overloaded in C{Ecef9Tuple}
-        '''(INTERNAL) Invoke C{ltp._toLocal}.
-        '''
-        Xyz_ = self._ltp_toLocal2(Xyz_kwds, **Xyz)
-        return self._ltp._toLocal(self, ltp, *Xyz_)  # self._ecef9
-
-    def _ltp_toLocal2(self, Xyz_kwds, _None=None, **Xyz):
-        '''(INTERNAL) Return 2-tuple C{(Xyz_Class, Xyz_kwds)}.
-        '''
-        C, _ = Xyz_ = _xkwds_pop2(Xyz_kwds, **Xyz)
-        if C is not _None:  # validate C
-            n, X = _xkwds_item2(Xyz)
-            if X is not C:
-                _xsubclassof(X, **{n: C})
-        return Xyz_
-
-    @property_ROver
-    def _ltpTuples(self):
-        '''(INTERNAL) Get module L{pygeodesy.ltpTuples}, I{once}.
-        '''
-        return _MODS.ltpTuples
-
-    def toAer(self, ltp=None, **Aer_and_kwds):
-        '''Convert this instance to I{local} I{Azimuth, Elevation, slant Range} (AER) components.
-
-           @kwarg ltp: The I{local tangent plane} (LTP) to use (L{Ltp}), overriding this
-                       instance' L{LTP<pygeodesy.named._NamedLocal.toLtp>}.
-           @kwarg Aer_and_kwds: Optional AER class C{B{Aer}=}L{Aer<pygeodesy.ltpTuples.Aer>}
-                      to use and optionally, additional B{C{Aer}} keyword arguments.
-
-           @return: An B{C{Aer}} instance.
-
-           @raise TypeError: Invalid B{C{ltp}}.
-
-           @see: Method L{toLocal<pygeodesy.named._NamedLocal.toLocal>}.
-        '''
-        return self._ltp_toLocal(ltp, Aer_and_kwds, Aer=self._ltpTuples.Aer)
-
-    def toEnu(self, ltp=None, **Enu_and_kwds):
-        '''Convert this instance to I{local} I{East, North, Up} (ENU) components.
-
-           @kwarg ltp: The I{local tangent plane} (LTP) to use (L{Ltp}), overriding this
-                       instance' L{LTP<pygeodesy.named._NamedLocal.toLtp>}.
-           @kwarg Enu_and_kwds: Optional ENU class C{B{Enu}=}L{Enu<pygeodesy.ltpTuples.Enu>}
-                      to use and optionally, additional B{C{Enu}} keyword arguments.
-
-           @return: An B{C{Enu}} instance.
-
-           @raise TypeError: Invalid B{C{ltp}}.
-
-           @see: Method L{toLocal<pygeodesy.named._NamedLocal.toLocal>}.
-        '''
-        return self._ltp_toLocal(ltp, Enu_and_kwds, Enu=self._ltpTuples.Enu)
-
-    def toLocal(self, Xyz=None, ltp=None, **Xyz_kwds):
-        '''Convert this instance to I{local} components in a I{local tangent plane} (LTP)
-
-           @kwarg Xyz: Optional I{local} components class (L{XyzLocal}, L{Aer},
-                       L{Enu}, L{Ned}) or C{None}.
-           @kwarg ltp: The I{local tangent plane} (LTP) to use (L{Ltp}), overriding this
-                       cartesian's L{LTP<pygeodesy.named._NamedLocal.toLtp>}.
-           @kwarg Xyz_kwds: Optionally, additional B{C{Xyz}} keyword arguments, ignored
-                            if C{B{Xyz} is None}.
-
-           @return: An B{C{Xyz}} instance or a L{Local9Tuple}C{(x, y, z, lat, lon,
-                    height, ltp, ecef, M)} if C{B{Xyz} is None} (with C{M=None}).
-
-           @raise TypeError: Invalid B{C{ltp}}.
-        '''
-        return self._ltp_toLocal(ltp, Xyz_kwds, Xyz=Xyz, _None=Xyz)
-
-    def toLtp(self, Ecef=None, **name):
-        '''Return the I{local tangent plane} (LTP) for this instance.
-
-           @kwarg Ecef: Optional ECEF I{class} (L{EcefKarney}, ... L{EcefYou}), overriding
-                        this instance' L{Ecef<pygeodesy.named._NamedLocal.Ecef>}.
-           @kwarg name: Optional C{B{name}=NN} (C{str}).
-
-           @return: An B{C{Ltp}} instance.
-        '''
-        return self._ltp._toLtp(self, Ecef, self._ecef9, name)  # needs self.Ecef and self._Ltp
-
-    def toNed(self, ltp=None, **Ned_and_kwds):
-        '''Convert this instance to I{local} I{North, East, Down} (NED) components.
-
-           @kwarg ltp: The I{local tangent plane} (LTP) to use (L{Ltp}), overriding this
-                       instance' L{LTP<pygeodesy.named._NamedLocal.toLtp>}.
-           @kwarg Ned_and_kwds: Optional NED class C{B{Ned}=}L{Ned<pygeodesy.ltpTuples.Ned>}
-                      to use and optionally, additional B{C{Ned}} keyword arguments.
-
-           @return: An B{C{Ned}} instance.
-
-           @raise TypeError: Invalid B{C{ltp}}.
-
-           @see: Method L{toLocal<pygeodesy.named._NamedLocal.toLocal>}.
-        '''
-        return self._ltp_toLocal(ltp, Ned_and_kwds, Ned=self._ltpTuples.Ned)
-
-    def toXyz(self, ltp=None, **Xyz_and_kwds):
-        '''Convert this instance to I{local} I{X, Y, Z} (XYZ) components.
-
-           @kwarg ltp: The I{local tangent plane} (LTP) to use (L{Ltp}), overriding this
-                       instance' L{LTP<pygeodesy.named._NamedLocal.toLtp>}.
-           @kwarg Xyz_and_kwds: Optional XYZ class C{B{Xyz}=}L{Xyz<pygeodesy.ltpTuples.XyzLocal>}
-                      to use and optionally, additional B{C{Xyz}} keyword arguments.
-
-           @return: An B{C{Xyz}} instance.
-
-           @raise TypeError: Invalid B{C{ltp}}.
-
-           @see: Method L{toLocal<pygeodesy.named._NamedLocal.toLocal>}.
-        '''
-        return self._ltp_toLocal(ltp, Xyz_and_kwds, Xyz=self._ltpTuples.XyzLocal)
-
-
 # from pygeodesy.props import _NamedProperty
 
 
@@ -1611,7 +1467,6 @@ def _xvalid(name, underOK=False):
 __all__ += _ALL_DOCS(_Named,
                      _NamedBase,  # _NamedDict,
                      _NamedEnum, _NamedEnumItem,
-                     _NamedLocal,
                      _NamedTuple)
 
 # **) MIT License

pygeodesy/namedTuples.py

@@ -10,7 +10,7 @@ of C{_NamedTuple} defined in C{pygeodesy.named}.
 
 from pygeodesy.basics import isinstanceof, issubclassof, map1, _xinstanceof
 # from pygeodesy.cartesianBase import CartesianBase  # _MODS
-# from pygeodesy.constants import INT0  # from .units
+from pygeodesy.constants import INT0
 # from pygeodesy.dms import toDMS  # _MODS
 from pygeodesy.errors import _TypeError, _xattr, _xkwds, _xkwds_not
 from pygeodesy.interns import NN, _1_, _2_, _a_, _A_, _area_, _angle_, _b_, _B_, \
@@ -26,10 +26,10 @@ from pygeodesy.props import deprecated_property_RO, property_RO
 from pygeodesy.units import Band, Bearing, Degrees, Degrees2, Easting, FIx, \
                             Height, Int, Lam, Lat, Lon, Meter, Meter2, \
                             Northing, Number_, Phi, Precision_, Radians, \
-                            Radius, Scalar, Str,  INT0
+                            Radius, Scalar, Str
 
 __all__ = _ALL_LAZY.namedTuples
-__version__ = '24.11.22'
+__version__ = '25.05.12'
 
 # __DUNDER gets mangled in class
 _closest_     = 'closest'

pygeodesy/nvectorBase.py

@@ -16,7 +16,7 @@ from pygeodesy.constants import EPS, EPS0, EPS1, EPS_2, R_M, \
 # from pygeodesy.datums import _spherical_datum  # from .formy
 from pygeodesy.errors import IntersectionError, _ValueError, VectorError, \
                             _xattrs, _xkwds, _xkwds_pop2
-from pygeodesy.fmath import fdot, fidw, hypot  # PYCHOK fdot shared
+from pygeodesy.fmath import fidw, hypot
 from pygeodesy.fsums import Fsum, fsumf_
 from pygeodesy.formy import _isequalTo,  _spherical_datum
 # from pygeodesy.internals import _under  # from .named
@@ -38,7 +38,7 @@ from pygeodesy.vector3d import Vector3d, _xyzhdlln4
 from math import degrees, fabs, sqrt
 
 __all__ = _ALL_LAZY.nvectorBase
-__version__ = '25.04.14'
+__version__ = '25.05.12'
 
 
 class NvectorBase(Vector3d):  # XXX kept private

pygeodesy/osgr.py

@@ -24,7 +24,7 @@ U{A Guide<https://www.OrdnanceSurvey.co.UK/documents/resources/guide-coordinate-
 and U{Ordnance Survey National Grid<https://WikiPedia.org/wiki/Ordnance_Survey_National_Grid>}.
 '''
 # make sure int/int division yields float quotient, see .basics
-from __future__ import division as _; del _  # PYCHOK semicolon
+from __future__ import division as _; del _  # noqa: E702 ;
 
 from pygeodesy.basics import halfs2, isbool, isfloat, map1, \
                             _splituple, _xsubclassof,  typename
@@ -54,7 +54,7 @@ from pygeodesy.utily import degrees90, degrees180, sincostan3, truncate
 from math import cos, fabs, radians, sin, sqrt
 
 __all__ = _ALL_LAZY.osgr
-__version__ = '25.04.12'
+__version__ = '25.05.12'
 
 _equivalent_ = 'equivalent'
 _OSGR_       = 'OSGR'

pygeodesy/points.py

@@ -52,8 +52,7 @@ from pygeodesy.named import classname, _NamedTuple, nameof, \
                             notImplemented, notOverloaded
 from pygeodesy.namedTuples import Bounds2Tuple, Bounds4Tuple, LatLon2Tuple, \
                                   NearestOn3Tuple, NearestOn5Tuple, \
-                                  Point3Tuple, Vector3Tuple, \
-                                  PhiLam2Tuple  # PYCHOK shared
+                                  Point3Tuple, Vector3Tuple
 from pygeodesy.props import Property_RO, property_doc_, property_RO
 from pygeodesy.streprs import Fmt, instr
 from pygeodesy.units import Number_, Radius, Scalar, Scalar_
@@ -63,7 +62,7 @@ from pygeodesy.utily import atan2b, degrees90, degrees180, degrees2m, \
 from math import cos, fabs, fmod as _fmod, radians, sin
 
 __all__ = _ALL_LAZY.points
-__version__ = '25.04.18'
+__version__ = '25.05.12'
 
 _ilat_  = 'ilat'
 _ilon_  = 'ilon'

pygeodesy/props.py

@@ -26,7 +26,7 @@ from pygeodesy.lazily import _ALL_LAZY, _ALL_MODS as _MODS, \
 from functools import wraps as _wraps
 
 __all__ = _ALL_LAZY.props
-__version__ = '25.04.14'
+__version__ = '25.05.21'
 
 _class_       = 'class'
 _DNL_         = _NL_ * 2  # PYCHOK used!
@@ -460,7 +460,7 @@ def _deprecated(call, kind, qual_d):
        @see: Brett Slatkin, "Effective Python", 2019 page 105, 2nd
              ed, Addison-Wesley.
     '''
-    doc = _DOCof(call)
+    doc = _DEPRECATEDof(call)
 
     @_wraps(call)  # PYCHOK self?
     def _deprecated_call(*args, **kwds):
@@ -517,6 +517,17 @@ def _deprecated_module(name):  # PYCHOK no cover
         _throwarning(_module_, name, _dont_use_)
 
 
+def _DEPRECATEDof(obj):
+    '''(INTERNAL) Get uniform DEPRECATED __doc__ string.
+    '''
+    try:
+        d = obj.__doc__.strip()
+        i = d.find(_DEPRECATED_)
+    except AttributeError:
+        i = -1
+    return _DOT_(_DEPRECATED_, NN) if i < 0 else d[i:]
+
+
 if _WARNINGS_X_DEV:
     class deprecated_property(_PropertyBase):
         '''Decorator for a DEPRECATED C{property} or C{Property}.
@@ -524,7 +535,7 @@ if _WARNINGS_X_DEV:
         def __init__(self, method):
             '''Decorator for a DEPRECATED C{property} or C{Property} getter.
             '''
-            doc = _DOCof(method)
+            doc = _DEPRECATEDof(method)
 
             def _fget(inst):  # PYCHOK no cover
                 '''Get the C{property} or C{Property} value.
@@ -554,7 +565,7 @@ if _WARNINGS_X_DEV:
                     '''Set the C{property} or C{Property} value.
                     '''
                     q = _qualified(inst, self.name)
-                    _throwarning(typename(property), q, _DOCof(method))
+                    _throwarning(typename(property), q, _DEPRECATEDof(method))
                     method(inst, val)
                     # self._update(inst)  # un-cache this item
 
@@ -594,7 +605,7 @@ def deprecated_property_RO(method):
 def _deprecated_RO(method, _RO):
     '''(INTERNAL) Create a DEPRECATED C{property_RO} or C{Property_RO}.
     '''
-    doc = _DOCof(method)
+    doc = _DEPRECATEDof(method)
 
     if _WARNINGS_X_DEV:
 
@@ -614,17 +625,6 @@ def _deprecated_RO(method, _RO):
         return _RO(method, doc=doc)
 
 
-def _DOCof(obj):
-    '''(INTERNAL) Get uniform DEPRECATED __doc__ string.
-    '''
-    try:
-        d = obj.__doc__.strip()
-        i = d.find(_DEPRECATED_)
-    except AttributeError:
-        i = -1
-    return _DOT_(_DEPRECATED_, NN) if i < 0 else d[i:]
-
-
 def _qualified(inst, name):
     '''(INTERNAL) Fully qualify a name.
     '''