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

pygeodesy/geoids.py

@@ -118,7 +118,7 @@ except ImportError:  # Python 3+
     from io import BytesIO as _BytesIO  # PYCHOK expected
 
 __all__ = _ALL_LAZY.geoids
-__version__ = '24.06.03'
+__version__ = '24.06.11'
 
 _assert_ = 'assert'
 _bHASH_  =  b'#'
@@ -323,10 +323,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location and height
                           (C{LatLon}) or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    center grid location.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon,
+                    height)} otherwise a B{C{LatLon}} instance with the lat-,
+                    longitude and geoid height of the center grid location.
         '''
         return self._llh3LL(self._center, LatLon)
 
@@ -437,10 +436,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location and height
                           (C{LatLon}) or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    highest grid location.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon,
+                    height)} otherwise a B{C{LatLon}} instance with the lat-,
+                    longitude and geoid height of the highest grid location.
         '''
         return self._llh3LL(self._highest, LatLon)
 
@@ -513,10 +511,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location
                           (C{LatLon}) and height or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    lower-left, SW grid corner.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon, height)}
+                    otherwise a B{C{LatLon}} instance with the lat-, longitude and
+                    geoid height of the lower-left, SW grid corner.
         '''
         return self._llh3LL(self._lowerleft, LatLon)
 
@@ -532,10 +529,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location and height
                           (C{LatLon}) or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    lower-right, SE grid corner.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon, height)}
+                    otherwise a B{C{LatLon}} instance with the lat-, longitude and
+                    geoid height of the lower-right, SE grid corner.
         '''
 
         return self._llh3LL(self._loweright, LatLon)
@@ -554,10 +550,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location and height
                           (C{LatLon}) or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    lowest grid location.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon,
+                    height)} otherwise a B{C{LatLon}} instance with the lat-,
+                    longitude and geoid height of the lowest grid location.
         '''
         return self._llh3LL(self._lowest, LatLon)
 
@@ -701,10 +696,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location and height
                           (C{LatLon}) or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    upper-left, NW grid corner.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon, height)}
+                    otherwise a B{C{LatLon}} instance with the lat-, longitude and
+                    geoid height of the upper-left, NW grid corner.
         '''
         return self._llh3LL(self._upperleft, LatLon)
 
@@ -720,10 +714,9 @@ class _GeoidBase(_HeightsBase):
            @kwarg LatLon: Optional class to return the location and height
                           (C{LatLon}) or C{None}.
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    upper-right, NE grid corner.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon, height)}
+                    otherwise a B{C{LatLon}} instance with the lat-, longitude and
+                    geoid height of the upper-right, NE grid corner.
         '''
         return self._llh3LL(self._upperright, LatLon)
 
@@ -1169,10 +1162,9 @@ class GeoidKarney(_GeoidBase):
                           (C{LatLon}) or C{None}.
            @kwarg full: Search the full or limited latitude range (C{bool}).
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height at the
-                    highest grid location.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon,
+                    height)} otherwise a B{C{LatLon}} instance with the lat-,
+                    longitude and geoid height of the highest grid location.
         '''
         llh = self._highest if full or self.cropped else self._highest_ltd
         return self._llh3LL(llh, LatLon)
@@ -1223,10 +1215,9 @@ class GeoidKarney(_GeoidBase):
                           (C{LatLon}) or C{None}.
            @kwarg full: Search the full or limited latitude range (C{bool}).
 
-           @return: If B{C{LatLon}} is C{None}, a L{LatLon3Tuple}C{(lat,
-                    lon, height)} otherwise a B{C{LatLon}} instance
-                    with the lat-, longitude and geoid height of the
-                    lowest grid location.
+           @return: If C{B{LatLon} is None}, a L{LatLon3Tuple}C{(lat, lon,
+                    height)} otherwise a B{C{LatLon}} instance with the lat-,
+                    longitude and geoid height of the lowest grid location.
         '''
         llh = self._lowest if full or self.cropped else self._lowest_ltd
         return self._llh3LL(llh, LatLon)

pygeodesy/hausdorff.py

@@ -72,21 +72,20 @@ from pygeodesy.datums import _ellipsoidal_datum, _WGS84
 from pygeodesy.errors import PointsError, _xattr, _xcallable, _xkwds, _xkwds_get
 import pygeodesy.formy as _formy
 from pygeodesy.interns import NN, _i_, _j_, _units_
-# from pygeodesy.iters import points2  # from .points
+# from pygeodesy.iters import points2 as _points  # from .points
 from pygeodesy.lazily import _ALL_LAZY, _FOR_DOCS
 from pygeodesy.named import _name2__, _Named, _NamedTuple, _Pass
 # from pygeodesy.namedTuples import PhiLam2Tuple  # from .points
-from pygeodesy.points import _distanceTo, points2 as _points2,  PhiLam2Tuple, radians
+from pygeodesy.points import _distanceTo,  PhiLam2Tuple, points2 as _points2, radians
 from pygeodesy.props import Property, Property_RO, property_doc_, property_RO
-from pygeodesy.units import Float, Number_, _xUnit, _xUnits
-from pygeodesy.unitsBase import _Str_degrees, _Str_degrees2, _Str_meter, _Str_NN, \
-                                _Str_radians, _Str_radians2
+from pygeodesy.units import Float, Number_
+from pygeodesy import unitsBase as _unitsBase  # _Str_..., _xUnit, _xUnits
 
 # from math import radians  # from .points
 from random import Random
 
 __all__ = _ALL_LAZY.hausdorff
-__version__ = '24.06.08'
+__version__ = '24.06.15'
 
 
 class HausdorffError(PointsError):
@@ -104,7 +103,7 @@ class Hausdorff(_Named):
     _kwds  = {}     # func_ options
     _model = ()
     _seed  =  None
-    _units = _Str_NN  # XXX Str to _Pass and for backward compatibility
+    _units = _unitsBase._Str_NN  # XXX Str to _Pass and for backward compatibility
 
     def __init__(self, point1s, seed=None, units=NN, **name__kwds):
         '''New C{Hausdorff...} calculator.
@@ -261,7 +260,7 @@ class Hausdorff(_Named):
 
            @raise TypeError: Invalid B{C{units}}.
         '''
-        self._units = _xUnits(units, Base=Float)
+        self._units = _unitsBase._xUnits(units, Base=Float)
 
     @Property_RO
     def wrap(self):
@@ -274,7 +273,7 @@ class HausdorffDegrees(Hausdorff):
     '''L{Hausdorff} base class for distances from C{LatLon}
        points in C{degrees}.
     '''
-    _units = _Str_degrees
+    _units = _unitsBase._Str_degrees
 
     if _FOR_DOCS:
         __init__  = Hausdorff.__init__
@@ -290,7 +289,7 @@ class HausdorffRadians(Hausdorff):
     '''L{Hausdorff} base class for distances from C{LatLon}
        points converted from C{degrees} to C{radians}.
     '''
-    _units = _Str_radians
+    _units = _unitsBase._Str_radians
 
     if _FOR_DOCS:
         __init__  = Hausdorff.__init__
@@ -318,8 +317,8 @@ class _HausdorffMeterRadians(Hausdorff):
        the optional keyword arguments supplied at instantiation
        of the C{Hausdorff*} sub-class.
     '''
-    _units  = _Str_meter
-    _units_ = _Str_radians
+    _units  = _unitsBase._Str_meter
+    _units_ = _unitsBase._Str_radians
 
     def directed(self, point2s, early=True):
         '''Overloaded method L{Hausdorff.directed} to determine
@@ -426,7 +425,7 @@ class HausdorffDistanceTo(Hausdorff):
     '''Compute the C{Hausdorff} distance based on the distance from the
        points' C{LatLon.distanceTo} method, conventionally in C{meter}.
     '''
-    _units = _Str_meter
+    _units = _unitsBase._Str_meter
 
     def __init__(self, point1s, **seed_name__distanceTo_kwds):
         '''New L{HausdorffDistanceTo} calculator.
@@ -464,7 +463,7 @@ class HausdorffEquirectangular(Hausdorff):
     '''Compute the C{Hausdorff} distance based on the C{equirectangular} distance
        in C{radians squared} like function L{pygeodesy.equirectangular}.
     '''
-    _units = _Str_degrees2
+    _units = _unitsBase._Str_degrees2
 
     def __init__(self, point1s, **seed_name__adjust_limit_wrap):
         '''New L{HausdorffEquirectangular} calculator.
@@ -513,7 +512,7 @@ class HausdorffExact(Hausdorff):
     '''Compute the C{Hausdorff} distance based on the I{angular}
        distance in C{degrees} from method L{GeodesicExact}C{.Inverse}.
     '''
-    _units = _Str_degrees
+    _units = _unitsBase._Str_degrees
 
     def __init__(self, point1s, datum=None, **seed_name__wrap):
         '''New L{HausdorffKarney} calculator.
@@ -543,7 +542,7 @@ class HausdorffFlatLocal(_HausdorffMeterRadians):
     '''Compute the C{Hausdorff} distance based on the I{angular} distance in
        C{radians squared} like function L{pygeodesy.flatLocal_}/L{pygeodesy.hubeny_}.
     '''
-    _units = _Str_radians2
+    _units = _unitsBase._Str_radians2
 
     def __init__(self, point1s, **seed_name__datum_scaled_wrap):
         '''New L{HausdorffFlatLocal}/L{HausdorffHubeny} calculator.
@@ -634,7 +633,7 @@ class HausdorffKarney(Hausdorff):
        <https://GeographicLib.SourceForge.io/Python/doc/code.html>}
        Inverse method.
     '''
-    _units = _Str_degrees
+    _units = _unitsBase._Str_degrees
 
     def __init__(self, point1s, datum=None, **seed_name__wrap):
         '''New L{HausdorffKarney} calculator.
@@ -823,7 +822,7 @@ class Hausdorff6Tuple(_NamedTuple):
         '''Overloaded C{_NamedTuple.toUnits} for C{hd} and C{md} units.
         '''
         u    = list(Hausdorff6Tuple._Units_)
-        u[0] = U = _xUnit(self.units, Float)  # PYCHOK expected
+        u[0] = U = _unitsBase._xUnit(self.units, Float)  # PYCHOK expected
         u[4] =     _Pass if self.md is None else U  # PYCHOK expected
         return _NamedTuple.toUnits(self.reUnit(*u), **Error_name)  # PYCHOK self
 

pygeodesy/heights.py

@@ -1,7 +1,7 @@
 
 # -*- coding: utf-8 -*-
 
-u'''Height interpolations at C{LatLon} points from C{knots}.
+u'''Height interpolations at C{LatLon} points from known C{knots}.
 
 Classes L{HeightCubic}, L{HeightIDWcosineAndoyerLambert},
 L{HeightIDWcosineForsytheAndoyerLambert}, L{HeightIDWcosineLaw},
@@ -91,7 +91,7 @@ from pygeodesy.units import _isDegrees, Float_, Int_
 # from math import radians  # from .points
 
 __all__ = _ALL_LAZY.heights
-__version__ = '24.06.03'
+__version__ = '24.06.22'
 
 _error_     = 'error'
 _formy      = _MODS.into(formy=__name__)

pygeodesy/internals.py

@@ -31,6 +31,12 @@ def _dunder_nameof(inst, *dflt):
     return dflt[0] if dflt else inst.__class__.__name__
 
 
+def _dunder_nameof_(*names__):  # in .errors._IsnotError
+    '''(INTERNAL) Yield the _dunder_nameof or name.
+    '''
+    return map(_dunder_nameof, names__, names__)
+
+
 def _Property_RO(method):
     '''(INTERNAL) Can't I{recursively} import L{props.property_RO}.
     '''

pygeodesy/interns.py

@@ -32,7 +32,7 @@ class _Int(int):
 class Str_(str):
     '''Extended, I{callable} C{str} class, not nameable.
 
-       @see: Nameable and callable class L{pygeodesy.Str}.
+       @see: Nameable and callable class L{Str<pygeodesy.unitsBase.Str>}.
     '''
     def join_(self, *args):
         '''Join all positional B{C{args}} like C{self.join(B{args})}.
@@ -441,7 +441,7 @@ _LR_PAIRS  = {_LANGLE_:  _RANGLE_,
 
 __all__ = (_NN_,  # NOT MISSING!
             Str_.__name__)  # classes
-__version__ = '24.06.05'
+__version__ = '24.06.14'
 
 if __name__ == '__main__':
 

pygeodesy/karney.py

@@ -160,7 +160,7 @@ from pygeodesy.utily import atan2d, sincos2d, tand, _unrollon,  fabs
 # from math import fabs  # from .utily
 
 __all__ = _ALL_LAZY.karney
-__version__ = '24.05.31'
+__version__ = '24.06.27'
 
 _K_2_0      = _getenv('PYGEODESY_GEOGRAPHICLIB', _2_) == _2_
 _perimeter_ = 'perimeter'
@@ -213,7 +213,7 @@ class Caps(object):  # PYCHOK
     EMPTY          =  0        # formerly aka NONE
     _CAP_1         =  1 << 0   # for goedesicw only
     _CAP_1p        =  1 << 1   # for goedesicw only
-#   _CAP_2         =  1 << 2
+    _CAP_2         =  1 << 2
     _CAP_3         =  1 << 3   # for goedesicw only
 #   _CAP_4         =  1 << 4
 #   _CAP_ALL       =  0x1F
@@ -233,7 +233,9 @@ class Caps(object):  # PYCHOK
     _DIRECT3       =  AZIMUTH  | LATITUDE | LONGITUDE | _CAP_3   # for goedesicw only
     _INVERSE3      =  AZIMUTH  | DISTANCE | _CAP_1   # for goedesicw only
     _STD           =  STANDARD | _CAP_3   | _CAP_1   # for goedesicw only
-    _STD_LINE      = _STD      | _CAP_1p   # for goedesicw only
+    _STD_LINE      = _STD      | _CAP_2   | _CAP_1p  # for goedesici and -w
+
+    LINE_CAPS      = _STD_LINE | REDUCEDLENGTH | GEODESICSCALE  # .geodesici only
 
     LINE_OFF       =  1 << 15  # Line without updates from parent geodesic or rhumb
     LONG_UNROLL    =  1 << 16  # unroll C{lon2} in .Direct and .Position
@@ -308,6 +310,10 @@ and C{ALL} - all of the above.
 
 C{STANDARD} = C{AZIMUTH | DISTANCE | DISTANCE_IN | LATITUDE | LONGITUDE}'''
 
+_KEY2Caps = dict(m12=Caps.REDUCEDLENGTH,  # see GDict._unCaps
+                 M12=Caps.GEODESICSCALE,
+                 M21=Caps.GEODESICSCALE, S12=Caps.AREA)
+
 
 class _CapsBase(_NamedBase):  # in .auxilats, .geodesicx.gxbases
     '''(INTERNAL) Base class for C{[_]Geodesic*Exact}.
@@ -320,11 +326,13 @@ class _CapsBase(_NamedBase):  # in .auxilats, .geodesicx.gxbases
     EMPTY         = Caps.EMPTY  # aka NONE
     GEODESICSCALE = Caps.GEODESICSCALE
     LATITUDE      = Caps.LATITUDE
+    LINE_CAPS     = Caps.LINE_CAPS
     LINE_OFF      = Caps.LINE_OFF
     LONGITUDE     = Caps.LONGITUDE
     LONG_UNROLL   = Caps.LONG_UNROLL
     REDUCEDLENGTH = Caps.REDUCEDLENGTH
     STANDARD      = Caps.STANDARD
+    _STD_LINE     = Caps._STD_LINE  # for geodesici
 
     _caps         = 0  # None
     _debug        = 0  # or Caps._DEBUG_...
@@ -453,6 +461,14 @@ class GDict(ADict):  # XXX _NamedDict
         t  = tuple(_g(self, n, dflt) for n in nTuple._Names_)
         return nTuple(t, iteration=self._iteration)
 
+    def _unCaps(self, outmask):  # in .geodsolve
+        '''(INTERNAL) Remove superfluous items.
+        '''
+        for k, m in _KEY2Caps.items():
+            if k in self and not (outmask & m):
+                self.pop(k)  # delattr(self, k)
+        return self
+
 
 class Inverse10Tuple(_GTuple):
     '''10-Tuple C{(a12, s12, salp1, calp1, salp2, calp2, m12, M12, M21, S12)} with arc length
@@ -882,7 +898,7 @@ def _unroll2(lon1, lon2, wrap=False):  # see .ellipsoidalBaseDI._intersects2
     '''Unroll B{C{lon2 - lon1}} like C{geodesic.Geodesic.Inverse}.
 
        @return: 2-Tuple C{(B{lon2} - B{lon1}, B{lon2})} with B{C{lon2}}
-                unrolled if B{C{wrap}} is C{True}, normalized otherwise.
+                unrolled if C{B{wrap} is True}, normalized otherwise.
     '''
     if wrap:
         d, t = _diff182(lon1, lon2)

pygeodesy/ktm.py

@@ -67,7 +67,7 @@ from cmath import polar
 from math import atan2, asinh, cos, cosh, degrees, fabs, sin, sinh, sqrt, tanh
 
 __all__ = _ALL_LAZY.ktm
-__version__ = '24.05.24'
+__version__ = '24.06.11'
 
 
 class KTMError(_ValueError):
@@ -119,18 +119,16 @@ class KTransverseMercator(_NamedBase):
                                    raiser=False, **TMorder_name):
         '''New L{KTransverseMercator}.
 
-           @kwarg a_earth: This rhumb's earth (L{Ellipsoid}, L{Ellipsoid2},
-                           L{a_f2Tuple}, L{Datum}, 2-tuple (C{a, f})) or the
-                           equatorial radius (C{scalar}, C{meter}).
-           @kwarg f: The ellipsoid's flattening (C{scalar}), iff B{C{a_earth}}
-                     is a C{scalar}, ignored otherwise.
+           @kwarg a_earth: This rhumb's earth (L{Ellipsoid}, L{Ellipsoid2}, L{a_f2Tuple},
+                           L{Datum}, 2-tuple (C{a, f})) or the equatorial radius (C{meter}).
+           @kwarg f: The ellipsoid's flattening (C{scalar}), required if B{C{a_earth}} is
+                     is C{meter}, ignored otherwise.
            @kwarg lon0: The central meridian (C{degrees180}).
            @kwarg k0: Central scale factor (C{scalar}).
-           @kwarg raiser: If C{True}, throw a L{KTMError} for C{forward}
-                          singularities (C{bool}).
-           @kwarg TMorder_name: Optional C{B{name}=NN} (C{str}) and optional
-                          keyword argument C{B{TMorder}=6} for the order of
-                          this L{KTransverseMercator}, see property C{TMorder}.
+           @kwarg raiser: If C{True}, throw a L{KTMError} for C{forward} singularities (C{bool}).
+           @kwarg TMorder_name: Optional C{B{name}=NN} (C{str}) and optional keyword argument
+                          C{B{TMorder}=6} for the order of this L{KTransverseMercator}, see
+                          property C{TMorder}.
 
            @raise KTMError: Invalid B{C{a_earth}}, B{C{f}} or B{C{TMorder}}.
         '''
@@ -229,14 +227,13 @@ class KTransverseMercator(_NamedBase):
            @arg lon0: Central meridian of the projection (C{degrees180}).
            @kwarg name: Optional C{B{name}=NN} (C{str}).
 
-           @return: L{Forward4Tuple}C{(easting, northing, gamma, scale)}
-                    with C{easting} and C{northing} in C{meter}, unfalsed, the
+           @return: L{Forward4Tuple}C{(easting, northing, gamma, scale)} with
+                    C{easting} and C{northing} in C{meter}, unfalsed, the
                     meridian convergence C{gamma} at point in C{degrees180}
                     and the C{scale} of projection at point C{scalar}.  Any
                     value may be C{NAN}, C{NINF} or C{INF} for singularities.
 
-           @raise KTMError: For singularities, iff property C{raiser} is
-                            C{True}.
+           @raise KTMError: For singularities, iff property C{raiser} is C{True}.
         '''
         lat, _lat = _unsigned2(_fix90(lat - self._lat0))
         lon, _    = _diff182((self.lon0 if lon0 is None else lon0), lon)
@@ -343,7 +340,7 @@ class KTransverseMercator(_NamedBase):
            @arg lat0: Latitude of the central parallel (C{degrees90}).
            @arg lon0: Longitude of the central parallel (C{degrees180}).
 
-           @return: 2-Tuple C{(lat0, lon0)} of the previous central
+           @return: 2-Tuple C{(lat0, lon0)} with the previous central
                     parallel and meridian.
 
            @raise KTMError: Invalid B{C{lat0}} or B{C{lon0}}.

pygeodesy/latlonBase.py

@@ -54,7 +54,7 @@ from contextlib import contextmanager
 from math import asin, cos, degrees, fabs, radians
 
 __all__ = _ALL_LAZY.latlonBase
-__version__ = '24.06.07'
+__version__ = '24.06.11'
 
 _formy = _MODS.into(formy=__name__)
 
@@ -143,17 +143,17 @@ class LatLonBase(_NamedBase):
            bounding box centered at this location.
 
            @arg wide: Longitudinal box width (C{meter}, same units as
-                      B{C{radius}} or C{degrees} if B{C{radius}} is C{None}).
+                      B{C{radius}} or C{degrees} if C{B{radius} is None}).
            @arg tall: Latitudinal box size (C{meter}, same units as
-                      B{C{radius}} or C{degrees} if B{C{radius}} is C{None}).
+                      B{C{radius}} or C{degrees} if C{B{radius} is None}).
            @kwarg radius: Mean earth radius (C{meter}) or C{None} if I{both}
                           B{C{wide}} and B{C{tall}} are in C{degrees}.
            @kwarg height: Height for C{latlonSW} and C{latlonNE} (C{meter}),
                           overriding the point's height.
            @kwarg name: Optional C{B{name}=NN} (C{str}).
 
-           @return: A L{Bounds2Tuple}C{(latlonSW, latlonNE)}, the
-                    lower-left and upper-right corner (C{LatLon}).
+           @return: A L{Bounds2Tuple}C{(latlonSW, latlonNE)}, the lower-left
+                    and upper-right corner (C{LatLon}).
 
            @see: U{https://www.Movable-Type.co.UK/scripts/latlong-db.html}
         '''
@@ -1396,13 +1396,12 @@ class LatLonBase(_NamedBase):
                           (C{meter}, conventionally).
            @kwarg Cartesian: Optional class to return the geocentric
                              coordinates (C{Cartesian}) or C{None}.
-           @kwarg Cartesian_kwds: Optional, additional B{C{Cartesian}}
-                                  keyword arguments, ignored if
-                                  C{B{Cartesian} is None}.
+           @kwarg Cartesian_kwds: Optional, additional B{C{Cartesian}} keyword
+                                  arguments, ignored if C{B{Cartesian} is None}.
 
-           @return: A B{C{Cartesian}} or if B{C{Cartesian}} is C{None},
-                    an L{Ecef9Tuple}C{(x, y, z, lat, lon, height, C, M,
-                    datum)} with C{C=0} and C{M} if available.
+           @return: A B{C{Cartesian}} or if B{C{Cartesian} is None}, an
+                    L{Ecef9Tuple}C{(x, y, z, lat, lon, height, C, M, datum)}
+                    with C{C=0} and C{M} if available.
 
            @raise TypeError: Invalid B{C{Cartesian}} or B{C{Cartesian_kwds}}.
 
@@ -1512,11 +1511,10 @@ class LatLonBase(_NamedBase):
                        additional B{C{Nvector}} keyword arguments, ignored if
                        C{B{Nvector} is None}.
 
-           @return: An B{C{Nvector}} or a L{Vector4Tuple}C{(x, y, z, h)} if
-                    B{C{Nvector}} is C{None}.
+           @return: An named B{C{Nvector}} or if C{B{Nvector} is None} a named
+                    L{Vector4Tuple}C{(x, y, z, h)}.
 
-           @raise TypeError: Invalid B{C{h}}, B{C{Nvector}} or
-                             B{C{name_Nvector_kwds}} item.
+           @raise TypeError: Invalid B{C{h}}, B{C{Nvector}} or B{C{name_Nvector_kwds}}.
 
            @see: Methods C{toCartesian}, C{toVector} and C{toVector3d}.
         '''
@@ -1548,7 +1546,7 @@ class LatLonBase(_NamedBase):
 
            @return: This point in the specified C{B{form}at}, etc. (C{str} or
                     a 2- or 3-tuple C{(lat_str, lon_str[, height_str])} if
-                    C{B{joined}=NN} or C{B{joined}=None}).
+                    B{C{joined}} is C{NN} or C{None}).
 
            @see: Function L{pygeodesy.latDMS} or L{pygeodesy.lonDMS} for more
                  details about keyword arguments C{B{form}at}, C{B{prec}ision},
@@ -1569,10 +1567,10 @@ class LatLonBase(_NamedBase):
            @kwarg Vector_kwds: Optional, additional B{C{Vector}} keyword
                                arguments, ignored if C{B{Vector} is None}.
 
-           @return: A named B{C{Vector}} or if B{C{Vector}} is C{None} a
+           @return: A named B{C{Vector}} or if C{B{Vector} is None} a
                     named L{Vector3Tuple}C{(x, y, z)}.
 
-           @raise TypeError: Invalid B{C{Vector}} or B{C{Vector_kwds}} item.
+           @raise TypeError: Invalid B{C{Vector}} or B{C{Vector_kwds}}.
 
            @see: Methods C{toCartesian}, C{toNvector} and C{toVector3d}.
         '''
@@ -1587,7 +1585,7 @@ class LatLonBase(_NamedBase):
 
            @return: Named, unit vector or vector (L{Vector3d}).
 
-           @raise TypeError: Invalid B{C{Vector3d_kwds}} item.
+           @raise TypeError: Invalid B{C{Vector3d_kwds}}.
 
            @see: Methods C{toCartesian}, C{toNvector} and C{toVector}.
         '''

pygeodesy/lazily.py

@@ -283,6 +283,7 @@ _ALL_LAZY = _NamedEnum_RO(_name='_ALL_LAZY',
                           fsums=_i('Fsum', 'DivMod2Tuple', 'Fsum2Tuple', 'ResidualError',
                                    'fsum', 'fsum_', 'fsumf_', 'fsum1', 'fsum1_', 'fsum1f_'),
                            gars=_i('Garef', 'GARSError'),
+                      geodesici=_i('Intersector', 'Intersector5Tuple', 'XDist'),
                       geodesicw=_i('Geodesic', 'GeodesicLine', 'Geodesic_WGS84'),
                       geodesicx=_i('gx', 'gxarea', 'gxbases', 'gxline',  # modules
                                    'GeodesicAreaExact', 'GeodesicExact', 'GeodesicLineExact', 'PolygonArea'),
@@ -367,9 +368,9 @@ _ALL_LAZY = _NamedEnum_RO(_name='_ALL_LAZY',
                           units=_i('Band', 'Bearing', 'Bearing_', 'Bool',
                                    'Degrees', 'Degrees_', 'Degrees2', 'Distance', 'Distance_', 'Easting', 'Epoch',
                                    'Feet', 'FIx', 'Float_', 'Height', 'Height_', 'HeightX', 'Int_',
-                                   'Lam', 'Lam_', 'Lat', 'Lat_', 'Lon', 'Lon_',
+                                   'Lam', 'Lamd', 'Lat', 'Lat_', 'Lon', 'Lon_',
                                    'Meter', 'Meter_', 'Meter2', 'Meter3', 'Northing', 'Number_',
-                                   'Phi', 'Phi_', 'Precision_', 'Radians', 'Radians_', 'Radians2',
+                                   'Phi', 'Phid', 'Precision_', 'Radians', 'Radians_', 'Radians2',
                                    'Radius_', 'Scalar', 'Scalar_', 'Zone'),
                       unitsBase=_i('Float', 'Int', 'Radius', 'Str'),
                             ups=_i('Ups', 'UPSError', 'parseUPS5', 'toUps8', 'upsZoneBand5'),
@@ -406,13 +407,13 @@ _ALL_DEPRECATED = _NamedEnum_RO(_name='_ALL_DEPRECATED',
                      deprecated_bases=_i('LatLonHeightBase', 'points2'),
                    deprecated_classes=_i('ClipCS3Tuple', 'EasNorExact4Tuple', 'EcefCartesian', 'Fn_rt',
                                          'HeightIDW', 'HeightIDW2', 'HeightIDW3', 'Helmert7Tuple',
-                                         'LatLonExact4Tuple', 'NearestOn4Tuple', 'Ned3Tuple',
-                                         'RefFrameError', 'Rhumb7Tuple', 'RhumbOrder2Tuple',
+                                         'Lam_', 'LatLonExact4Tuple', 'NearestOn4Tuple', 'Ned3Tuple',
+                                         'Phi_', 'RefFrameError', 'Rhumb7Tuple', 'RhumbOrder2Tuple',
                                          'Transform7Tuple', 'TriAngle4Tuple', 'UtmUps4Tuple'),
                  deprecated_consterns=_i('EPS1_2', 'MANTIS', 'OK'),
                      deprecated_datum=_i('Curvature2Tuple', 'Datum',  'Ellipsoid',  'Transform',  # assert
                                                             'Datums', 'Ellipsoids', 'Transforms',
-                                         'R_M', 'R_MA', 'R_MB', 'R_KM', 'R_NM', 'R_SM', 'R_FM', 'R_VM'),
+                                         'R_FM', 'R_KM', 'R_M', 'R_MA', 'R_MB', 'R_NM', 'R_SM', 'R_VM'),
                  deprecated_functions=_i('anStr', 'areaof', 'atand', 'bounds',  # most of the DEPRECATED functions, except ...
                                          'clipCS3', 'clipDMS', 'clipStr', 'collins', 'copysign',  # ...  ellipsoidal, spherical flavors
                                          'decodeEPSG2', 'encodeEPSG', 'enStr2', 'equirectangular_', 'equirectangular3',
@@ -518,7 +519,7 @@ class _ALL_MODS(_internals._MODS_Base):
 _internals._MODS = _ALL_MODS = _ALL_MODS()  # PYCHOK singleton
 
 __all__ = _ALL_LAZY.lazily
-__version__ = '24.06.05'
+__version__ = '24.06.19'
 
 
 def _ALL_OTHER(*objs):