pygeodesy 24.8.4__py2.py3-none-any.whl → 24.9.9__py2.py3-none-any.whl

pygeodesy/booleans.py

@@ -24,10 +24,10 @@ from pygeodesy.errors import ClipError, _IsnotError, _TypeError, \
 from pygeodesy.fmath import favg, hypot, hypot2
 # from pygeodesy.fsums import fsum1  # _MODS
 from pygeodesy.interns import NN, _BANG_, _clip_, _clipid_, _COMMASPACE_, \
-                             _composite_, _DOT_, _e_, _ELLIPSIS_, _few_, \
-                             _height_, _lat_, _LatLon_, _lon_, _not_, \
-                             _points_, _SPACE_, _too_, _X_, _x_, \
-                             _B_, _d_, _R_  # PYCHOK used!
+                             _composite_, _DOT_, _duplicate_, _e_, \
+                             _ELLIPSIS_, _few_, _height_, _lat_, _LatLon_, \
+                             _lon_, _not_, _points_, _SPACE_, _too_, _X_, \
+                             _x_,  _B_, _d_, _R_  # PYCHOK used!
 from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS
 from pygeodesy.latlonBase import LatLonBase, \
                                  LatLon2Tuple, Property_RO, property_RO
@@ -43,7 +43,7 @@ from pygeodesy.utily import fabs, _unrollon, _Wrap
 # from math import fabs  # from .utily
 
 __all__ = _ALL_LAZY.booleans
-__version__ = '24.06.15'
+__version__ = '24.08.30'
 
 _0_EPS =  EPS  # near-zero, positive
 _EPS_0 = -EPS  # near-zero, negative
@@ -51,12 +51,11 @@ _1_EPS = _1_0 + EPS   # near-one, over
 _EPS_1 = _1_0 - EPS   # near-one, under
 _10EPS =  EPS * 10    # see ._2Abs, ._10eps
 
-_alpha_     = 'alpha'
-_boolean_   = 'boolean'
-_case_      = 'case'
-_corners_   = 'corners'
-_duplicate_ = 'duplicate'
-_open_      = 'open'
+_alpha_   = 'alpha'
+_boolean_ = 'boolean'
+_case_    = 'case'
+_corners_ = 'corners'
+_open_    = 'open'
 
 
 def _Enum(txt, enum):  # PYCHOK unused

pygeodesy/cartesianBase.py

@@ -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.07.29'
+__version__ = '24.08.18'
 
 _r_     = 'r'
 _theta_ = 'theta'
@@ -342,9 +342,9 @@ class CartesianBase(Vector3d):
                          I{overriding} this datum (L{Datum}, L{Ellipsoid},
                          L{Ellipsoid2}, L{a_f2Tuple}, L{Triaxial}, L{Triaxial_},
                          L{JacobiConformal} or C{meter}, conventionally).
-           @kwarg normal: If C{True} the projection is the nearest point on the
+           @kwarg normal: If C{True}, the projection is the nearest point on the
                           ellipsoid's surface, otherwise the intersection of the
-                          radial line to the ellipsoid's center and the surface.
+                          radial line to the ellipsoid's center and surface C{bool}).
            @kwarg Cartesian_and_kwds: Optional C{B{Cartesian}=None} class to return
                             the I{projection} and additional B{C{Cartesian}} keyword
                             arguments.
@@ -437,7 +437,7 @@ class CartesianBase(Vector3d):
         # <https://GitHub.com/pbrod/nvector>/src/nvector/core.py>
         # _equation23 and <https://www.NavLab.net/nvector>
         E = datum.ellipsoid
-        x, y, z = self.xyz
+        x, y, z = self.xyz3
 
         # Kenneth Gade eqn 23
         p = hypot2(x, y) * E.a2_
@@ -836,7 +836,7 @@ class CartesianBase(Vector3d):
             # if inverse and d != _WGS84:
             #     raise _ValueError(inverse=inverse, datum=d,
             #                       txt_not_=_WGS84.name)
-            xyz = transform.transform(*self.xyz, inverse=inverse)
+            xyz = transform.transform(*self.xyz3, inverse=inverse)
             c = self.dup(xyz=xyz, datum=datum or self.datum)
         return c
 

pygeodesy/constants.py

@@ -17,14 +17,14 @@ from pygeodesy.interns import _INF_, _NAN_, _UNDER_
 # from pygeodesy.streprs import Fmt  # from .unitsBase
 from pygeodesy.unitsBase import Float, Int, Radius,  _ALL_LAZY, Fmt
 
-from math import fabs, isinf, isnan, pi as _PI, sqrt
+from math import fabs, isinf, isnan, pi as _pi, sqrt
 try:
     from math import inf as _inf, nan as _nan  # PYCHOK Python 3+
 except ImportError:  # Python 2-
     _inf, _nan = float(_INF_), float(_NAN_)
 
 __all__ = _ALL_LAZY.constants
-__version__ = '24.05.29'
+__version__ = '24.08.26'
 
 
 def _copysign_0_0(y):
@@ -100,7 +100,7 @@ def float0_(*xs):
         yield float(x) if x else _0_0
 
 
-def _float0(f):  # in .resections, .vector3dBase, ...
+def _float0(f):  # in .auxilats.auxily, .resections, .vector3dBase, ...
     '''(INTERNAL) Return C{float(B{f})} or C{INT0}.
     '''
     if f:
@@ -181,6 +181,7 @@ _10_0    = _float(  10)       # PYCHOK expected
 _16_0    = _float(  16)       # PYCHOK expected
 _32_0    = _float(  32)       # PYCHOK expected
 _60_0    = _float(  60)       # PYCHOK expected
+_64_0    = _float(  64)       # PYCHOK expected
 _90_0    = _float(  90)       # PYCHOK expected
 _100_0   = _float( 100)       # PYCHOK expected
 _180_0   = _float( 180)       # PYCHOK expected
@@ -224,30 +225,30 @@ except ImportError:  # PYCHOK no cover
     MIN_EXP  =  Int(MIN_EXP   =_log2(MIN))  # -307 base 10
 #   RADIX    =  Int(Radix     =2)           # base
 
-EPS0     = _Float( EPS0   = EPS**2)         # PYCHOK near-/non-zero comparison 4.930381e-32, or EPS or EPS_2
-EPS02    = _Float( EPS02  = EPS**4)         # PYCHOK near-zero-squared comparison 2.430865e-63
-EPS_2    = _Float( EPS_2  = EPS / _2_0)     # PYCHOK ≈ 1.110223024625e-16
-EPS1     = _Float( EPS1   =_1_0 - EPS)      # PYCHOK ≈ 0.9999999999999998
-EPS2     = _Float( EPS2   = EPS * _2_0)     # PYCHOK ≈ 4.440892098501e-16
-EPS4     = _Float( EPS4   = EPS * _4_0)     # PYCHOK ≈ 8.881784197001e-16
-# _1EPS  = _Float(_1EPS   =_1_0 + EPS)      # PYCHOK ≈ 1.0000000000000002
-_1_EPS   = _Float(_1_EPS  =_1_0 / EPS)      # PYCHOK = 4503599627370496.0
-# _2_EPS = _Float(_2_EPS  =_2_0 / EPS)      # PYCHOK = 9007199254740992.0
-_EPS2e4  = _Float(_EPS2e4 = EPS2 * 1.e4)    # PYCHOK ≈ 4.440892098501e-12
-_EPS4e8  = _Float(_EPS4e8 = EPS4 * 1.e8)    # PYCHOK ≈ 8.881784197001e-08
-_EPSmin  = _Float(_EPSmin = sqrt(MIN))      # PYCHOK = 1.49166814624e-154
-_EPSqrt  = _Float(_EPSqrt = sqrt(EPS))      # PYCHOK = 1.49011611938e5-08
-_EPStol  = _Float(_EPStol =_EPSqrt * _0_1)  # PYCHOK = 1.49011611938e5-09 == sqrt(EPS * _0_01)
-
-_89_999_ = _Float(_89_999_= EPS1 * _90_0)   # just below 90.0
+EPS0     = _Float( EPS0  = EPS**2)          # PYCHOK near-/non-zero comparison 4.930381e-32, or EPS or EPS_2
+EPS02    = _Float( EPS02 = EPS**4)          # PYCHOK near-zero-squared comparison 2.430865e-63
+EPS_2    = _Float( EPS_2 = EPS / _2_0)      # PYCHOK ≈ 1.110223024625e-16
+EPS1     = _Float( EPS1  =_1_0 - EPS)       # PYCHOK ≈ 0.9999999999999998
+EPS2     = _Float( EPS2  = EPS * _2_0)      # PYCHOK ≈ 4.440892098501e-16
+EPS4     = _Float( EPS4  = EPS * _4_0)      # PYCHOK ≈ 8.881784197001e-16
+# _1EPS  = _Float(_1EPS  =_1_0 + EPS)       # PYCHOK ≈ 1.0000000000000002
+_1_EPS   = _Float(_1_EPS =_1_0 / EPS)       # PYCHOK = 4503599627370496.0
+# _2_EPS = _Float(_2_EPS =_2_0 / EPS)       # PYCHOK = 9007199254740992.0
+_EPS2e4  = _Float(_EPS2e4= EPS2 * 1.e4)     # PYCHOK ≈ 4.440892098501e-12
+_EPS4e8  = _Float(_EPS4e8= EPS4 * 1.e8)     # PYCHOK ≈ 8.881784197001e-08
+_EPSjam  = _Float(_EPSjam= pow(EPS, 0.75))  # PYCHOK = 1.818989403546e-12
+_EPSmin  = _Float(_EPSmin= sqrt(MIN))       # PYCHOK = 1.49166814624e-154
+_EPSqrt  = _Float(_EPSqrt= sqrt(EPS))       # PYCHOK = 1.49011611938e5-08
+_EPStol  = _Float(_EPStol=_EPSqrt * _0_1)   # PYCHOK = 1.49011611938e5-09 == sqrt(EPS * _0_01)
+
+_89_999  = _Float(_89_999=_90_0 * EPS1)  # just below 90.0
 # <https://Numbers.Computation.Free.FR/Constants/Miscellaneous/digits.html>
-_1__90   = _Float(_1__90  =_1_0 / _90_0)    # PYCHOK = 0.011_111_111_111_111_111_111_111_111_111_111_111_111_111_111_11111
-_2__PI   = _Float(_2__PI  =_2_0 / _PI)      # PYCHOK = 0.636_619_772_367_581_343_075_535_053_490_057_448_137_838_582_96182
+_1__90   = _Float(_1__90 =_1_0 / _90_0)  # PYCHOK = 0.011_111_111_111_111_111_111_111_111_111_111_111_111_111_111_11111
+_2__PI   = _Float(_2__PI =_2_0 / _pi)    # PYCHOK = 0.636_619_772_367_581_343_075_535_053_490_057_448_137_838_582_96182
 
-_1_16th  = _Float(_1_16th =_1_0 / _16_0)  # PYCHOK in .ellipsoids, .karney
-_1_64th  = _Float(_1_64th =_1_0 /  64)    # PYCHOK in .elliptic, pow(2.0, -6)
-_1_3rd   = _Float(_1_3rd  =_1_0 /  _3_0)  # PYCHOK in .fmath
-_1_6th   = _Float(_1_6th  =_1_0 /  _6_0)  # PYCHOK in .fmath
+_1_16th  = _Float(_1_16th=_1_0 / _16_0)  # PYCHOK in .ellipsoids, .karney
+_1_3rd   = _Float(_1_3rd =_1_0 /  _3_0)  # PYCHOK in .fmath
+_1_6th   = _Float(_1_6th =_1_0 /  _6_0)  # PYCHOK in .fmath
 
 _K0_UTM  = _Float(_K0_UTM = 0.9996)  # PYCHOK in .etm, .ktm, .utm, UTM scale at central meridian
 # sqrt(2) <https://WikiPedia.org/wiki/Square_root_of_2>
@@ -261,14 +262,14 @@ NAN   =  Float(NAN =_nan)    # PYCHOK Not-A-Number, see function L{isnan}, NOT _
 NEG0  =  Float(NEG0=_N_0_0)  # PYCHOK NEGative 0.0, see function L{isneg0}, NOT _Float!
 NINF  =  Float(NINF=-INF)    # PYCHOK Negative INFinity, NOT _Float!
 
-PI    = _Float(PI   =_PI)         # 3.1415_9265_3589_7932_3846_2643_3832_795
-PI2   = _Float(PI2  =_PI * _2_0)  # PYCHOK Two PI, M{PI * 2} aka I{Tau}
-PI_2  = _Float(PI_2 =_PI / _2_0)  # PYCHOK Half PI, M{PI / 2}
-PI3   = _Float(PI3  =_PI * _3_0)  # PYCHOK Three PI, M{PI * 3}
-PI3_2 = _Float(PI3_2=_PI * _1_5)  # PYCHOK PI and a half, M{PI * 3 / 2}
-PI_3  = _Float(PI_3 =_PI / _3_0)  # PYCHOK One third PI, M{PI / 3}
-PI4   = _Float(PI4  =_PI * _4_0)  # PYCHOK Four PI, M{PI * 4}
-PI_4  = _Float(PI_4 =_PI / _4_0)  # PYCHOK Quarter PI, M{PI / 4}
+PI    = _Float(PI   =_pi)         # 3.1415_9265_3589_7932_3846_2643_3832_795
+PI2   = _Float(PI2  =_pi * _2_0)  # PYCHOK Two PI, M{PI * 2} aka I{Tau}
+PI_2  = _Float(PI_2 =_pi / _2_0)  # PYCHOK Half PI, M{PI / 2}
+PI3   = _Float(PI3  =_pi * _3_0)  # PYCHOK Three PI, M{PI * 3}
+PI3_2 = _Float(PI3_2=_pi * _1_5)  # PYCHOK PI and a half, M{PI * 3 / 2}
+PI_3  = _Float(PI_3 =_pi / _3_0)  # PYCHOK One third PI, M{PI / 3}
+PI4   = _Float(PI4  =_pi * _4_0)  # PYCHOK Four PI, M{PI * 4}
+PI_4  = _Float(PI_4 =_pi / _4_0)  # PYCHOK Quarter PI, M{PI / 4}
 
 R_MA  = _Radius(R_MA=6378137.0)       # PYCHOK equatorial earth radius (C{meter}), WGS84, EPSG:3785
 R_MB  = _Radius(R_MB=6356752.3)       # PYCHOK polar earth radius (C{meter}), WGS84, EPSG:3785
@@ -441,7 +442,7 @@ def isnon0(x, eps0=EPS0):
 def _off90(lat):
     '''(INTERNAL) Off 90.0 for .gars and .wgrs.
     '''
-    return max(min(lat, _89_999_), -_89_999_)
+    return max(min(lat, _89_999), -_89_999)
 
 
 try:

pygeodesy/ellipsoidalBase.py

@@ -35,7 +35,7 @@ from pygeodesy.units import Epoch, _isDegrees, Radius_, _1mm as _TOL_M
 # from math import fabs  # from .latlonBase
 
 __all__ = _ALL_LAZY.ellipsoidalBase
-__version__ = '24.06.24'
+__version__ = '24.08.14'
 
 
 class CartesianEllipsoidalBase(CartesianBase):
@@ -111,7 +111,7 @@ class CartesianEllipsoidalBase(CartesianBase):
                          C{Vector3Tuple} or C{Vector4Tuple}).
            @arg radius2: Radius of the second sphere or circle (same units as this and
                          the B{C{other}} point's coordinates).
-           @kwarg sphere: If C{True} compute the center and radius of the intersection
+           @kwarg sphere: If C{True}, compute the center and radius of the intersection
                           of two I{spheres}.  If C{False}, ignore the C{z}-component and
                           compute the intersection of two I{circles} (C{bool}).
            @kwarg Vector: Class to return intersections (C{Cartesian}, L{Vector3d} or
@@ -527,7 +527,7 @@ class LatLonEllipsoidalBase(LatLonBase):
                   point is computed as the C{destination} along that bearing at
                   about 1.5 times the distance from the start point to an initial
                   gu-/estimate of the intersection point (and between 1/8 and 3/8
-                  of the authalic earth perimeter).
+                  of the C{authalic} earth perimeter).
 
            @see: I{Karney's} U{intersect.cpp<https://SourceForge.net/p/geographiclib/
                  discussion/1026621/thread/21aaff9f/>}, U{The B{ellipsoidal} case<https://
@@ -659,7 +659,7 @@ class LatLonEllipsoidalBase(LatLonBase):
 
            @arg point1: Start point (C{LatLon}).
            @arg point2: End point (C{LatLon}).
-           @kwarg within: If C{True} return the closest point I{between}
+           @kwarg within: If C{True}, return the closest point I{between}
                           B{C{point1}} and B{C{point2}}, otherwise the
                           closest point elsewhere on the geodesic (C{bool}).
            @kwarg height: Optional height for the closest point (C{meter},
@@ -714,8 +714,8 @@ class LatLonEllipsoidalBase(LatLonBase):
                          I{without conversion}.
            @kwarg epoch: Optional datum (L{Epoch}), overriding this epoch
                          I{without conversion}.
-           @kwarg reframe: Optional datum (L{RefFrame}), overriding this
-                           reframe I{without conversion}.
+           @kwarg reframe: Optional reference frame (L{RefFrame}), overriding
+                           this reframe I{without conversion}.
            @kwarg sep: Optional separator (C{str}).
            @kwarg wrap: If C{True}, wrap or I{normalize} the lat- and
                         longitude (C{bool}).
@@ -726,7 +726,8 @@ class LatLonEllipsoidalBase(LatLonBase):
            @raise ParseError: Invalid B{C{strllh}}.
         '''
         a, b, h = _MODS.dms.parse3llh(strllh, height=height, sep=sep, wrap=wrap)
-        r = self.classof(a, b, height=h, datum=self.datum)
+        r = self.classof(a, b, height=h, datum=self.datum, epoch=self.epoch,
+                                                         reframe=self.reframe)
         if datum not in (None, self.datum):
             r.datum = datum
         if epoch not in (None, self.epoch):
@@ -865,7 +866,7 @@ class LatLonEllipsoidalBase(LatLonBase):
     def toOsgr(self, kTM=False, **toOsgr_kwds):
         '''Convert this C{LatLon} point to an OSGR coordinate.
 
-           @kwarg kTM: If C{True} use I{Karney}'s Krüger method from module
+           @kwarg kTM: If C{True}, use I{Karney}'s Krüger method from module
                        L{ktm}, otherwise I{Ordinance Survery}'s recommended
                        formulation (C{bool}).
            @kwarg toOsgr_kwds: Optional L{pygeodesy.toOsgr} keyword arguments.
@@ -1008,13 +1009,15 @@ class LatLonEllipsoidalBase(LatLonBase):
 
            @arg bearing1: Bearing at this point (compass C{degrees360}).
            @arg other: Start point of the other line (C{LatLon}).
-           @arg bearing2: Bearing at the other point (compass C{degrees360}).
+           @arg bearing2: Bearing at the B{C{other}} point (compass C{degrees360}).
            @kwarg height_wrap_tol: Optional keyword arguments C{B{height}=None},
-                         C{B{wrap}=False} and C{B{tol}}, see method L{intersection3}.
+                         C{B{wrap}=False} and C{B{tol}}, see method L{intersection3
+                         <pygeodesy.ellipsoidalBase.LatLonEllipsoidalBase>}.
 
            @return: Triangulated point (C{LatLon}).
 
-           @see: Method L{intersection3} for further details.
+           @see: Method L{intersection3<pygeodesy.ellipsoidalBase.LatLonEllipsoidalBase>}
+                 for further details.
         '''
         if _isDegrees(bearing1) and _isDegrees(bearing2):
             r = self.intersection3(bearing1, other, bearing2, **height_wrap_tol)
@@ -1034,13 +1037,13 @@ class LatLonEllipsoidalBase(LatLonBase):
            @arg point3: Third center point (C{LatLon}).
            @arg distance3: Distance to point3 (C{meter}, same units as
                            B{C{eps}}).
-           @kwarg area: If C{True} compute the area overlap, otherwise the
+           @kwarg area: If C{True}, compute the area overlap, otherwise the
                         perimeter intersection of the circles (C{bool}).
            @kwarg eps: The required I{minimal overlap} for C{B{area}=True}
                        or the I{intersection margin} for C{B{area}=False}
                        (C{meter}, conventionally).
-           @kwarg wrap: If C{True}, wrap or I{normalize} and unroll
-                        B{C{point2}} and B{C{point3}} (C{bool}).
+           @kwarg wrap: If C{True}, wrap or I{normalize} and unroll B{C{point2}}
+                        and B{C{point3}} (C{bool}).
 
            @return: A L{Trilaterate5Tuple}C{(min, minPoint, max, maxPoint, n)}
                     with C{min} and C{max} in C{meter}, same units as B{C{eps}},
@@ -1049,7 +1052,7 @@ class LatLonEllipsoidalBase(LatLonBase):
                     of trilatered points found for the given B{C{eps}}.
 
                     If only a single trilaterated point is found, C{min I{is}
-                    max}, C{minPoint I{is} maxPoint} and C{n = 1}.
+                    max}, C{minPoint I{is} maxPoint} and C{n=1}.
 
                     For C{B{area}=True}, C{min} and C{max} are the smallest
                     respectively largest I{radial} overlap found.

pygeodesy/ellipsoidalExact.py

@@ -24,7 +24,7 @@ from pygeodesy.points import _areaError, ispolar  # PYCHOK exported
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.ellipsoidalExact
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 
 class Cartesian(CartesianEllipsoidalBase):
@@ -252,7 +252,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalGeodSolve.py

@@ -24,7 +24,7 @@ from pygeodesy.points import _areaError, ispolar  # PYCHOK exported
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.ellipsoidalGeodSolve
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 
 class Cartesian(CartesianEllipsoidalBase):
@@ -244,7 +244,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalKarney.py

@@ -42,7 +42,7 @@ from pygeodesy.props import deprecated_method, Property_RO
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.ellipsoidalKarney
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 
 class Cartesian(CartesianEllipsoidalBase):
@@ -279,7 +279,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalNvector.py

@@ -48,7 +48,7 @@ from pygeodesy.units import Bearing, Distance, Height, Scalar
 # from math import fabs  # from .nvectorBase
 
 __all__ = _ALL_LAZY.ellipsoidalNvector
-__version__ = '24.06.15'
+__version__ = '24.08.13'
 
 
 class Ned(_Ned):
@@ -555,7 +555,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalVincenty.py

@@ -59,7 +59,7 @@ from pygeodesy.errors import _and, _ValueError, _xkwds
 from pygeodesy.fmath import Fpolynomial, hypot, hypot1
 from pygeodesy.interns import _ambiguous_, _antipodal_, _COLONSPACE_, \
                               _to_, _SPACE_,  _limit_  # PYCHOK used!
-from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS, _ALL_OTHER
+from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS
 from pygeodesy.namedTuples import Destination2Tuple, Destination3Tuple, \
                                   Distance3Tuple
 from pygeodesy.points import Fmt, ispolar  # PYCHOK exported
@@ -72,7 +72,7 @@ from pygeodesy.utily import atan2b, atan2d, sincos2, sincos2d, unroll180, wrap18
 from math import atan2, cos, degrees, fabs, radians, tan
 
 __all__ = _ALL_LAZY.ellipsoidalVincenty
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 _antipodal_to_ = _SPACE_(_antipodal_, _to_)
 
@@ -510,7 +510,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},
@@ -560,9 +560,10 @@ def perimeterOf(points, **closed_datum_wrap):
         return _MODS.ellipsoidalExact.perimeterOf(points, **closed_datum_wrap)
 
 
-__all__ += _ALL_OTHER(Cartesian, LatLon, intersecant2,  # from .ellipsoidalBaseDI
-                      intersection3, intersections2, ispolar,  # from .points
-                      nearestOn) + _ALL_DOCS(areaOf, perimeterOf)  # deprecated
+__all__ += _ALL_DOCS(Cartesian, LatLon, intersecant2,  # from .ellipsoidalBaseDI
+                     intersection3, intersections2, ispolar,  # from .points
+                     nearestOn,
+                     areaOf, perimeterOf)  # DEPRECATED
 
 # **) MIT License
 #