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

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.12'
+__version__ = '24.08.18'
 
 _r_     = 'r'
 _theta_ = 'theta'
@@ -300,7 +300,7 @@ class CartesianBase(Vector3d):
                     coordinates I{at height} in C{meter}, conventionally.
 
            @note: This cartesian's coordinates are returned if B{C{earth}} and this
-                  datum or B{C{heigth}} and/or this height are C{None} or undefined.
+                  datum or B{C{height}} and/or this height are C{None} or undefined.
 
            @note: Include keyword argument C{B{datum}=None} if class B{C{Cartesian}}
                   does not accept a B{C{datum}} keyword agument.
@@ -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.18'
 
 
 def _copysign_0_0(y):
@@ -242,7 +242,7 @@ _EPStol  = _Float(_EPStol =_EPSqrt * _0_1)  # PYCHOK = 1.49011611938e5-09 == sqr
 _89_999_ = _Float(_89_999_= EPS1 * _90_0)   # 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
+_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)
@@ -261,14 +261,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

pygeodesy/css.py

@@ -27,13 +27,13 @@ from pygeodesy.namedTuples import EasNor2Tuple, EasNor3Tuple, \
 from pygeodesy.props import deprecated_Property_RO, Property, \
                                        Property_RO, _update_all
 from pygeodesy.streprs import Fmt, _fstrENH2, _fstrLL0, _xzipairs
-from pygeodesy.units import Bearing, Degrees, Easting, Height, _heigHt, \
+from pygeodesy.units import Azimuth, Degrees, Easting, Height, _heigHt, \
                             Lat_, Lon_, Northing, Scalar
 
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.css
-__version__ = '24.06.11'
+__version__ = '24.07.25'
 
 
 def _CS0(cs0):
@@ -578,7 +578,7 @@ class EasNorAziRk4Tuple(_NamedTuple):
        C{reciprocal} of azimuthal northing scale, both in C{degrees}.
     '''
     _Names_ = (_easting_, _northing_, _azimuth_, _reciprocal_)
-    _Units_ = ( Easting,   Northing,   Bearing,   Scalar)
+    _Units_ = ( Easting,   Northing,   Azimuth,   Scalar)
 
 
 class EasNorAziRkEqu6Tuple(_NamedTuple):
@@ -589,7 +589,7 @@ class EasNorAziRkEqu6Tuple(_NamedTuple):
        C{equatorarc} and C{equatorazimuth}, all in C{degrees}.
     '''
     _Names_ = EasNorAziRk4Tuple._Names_ + ('equatorarc', 'equatorazimuth')
-    _Units_ = EasNorAziRk4Tuple._Units_ + ( Degrees,      Bearing)
+    _Units_ = EasNorAziRk4Tuple._Units_ + ( Degrees,      Azimuth)
 
 
 class LatLonAziRk4Tuple(_NamedTuple):
@@ -598,7 +598,7 @@ class LatLonAziRk4Tuple(_NamedTuple):
        C{reciprocal} the reciprocal of azimuthal northing scale.
     '''
     _Names_ = (_lat_, _lon_, _azimuth_, _reciprocal_)
-    _Units_ = ( Lat_,  Lon_,  Bearing,   Scalar)
+    _Units_ = ( Lat_,  Lon_,  Azimuth,   Scalar)
 
 
 def toCss(latlon, cs0=None, height=None, Css=Css, **name):

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
 #

pygeodesy/ellipsoids.py

@@ -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.07.16'
+__version__ = '24.07.25'
 
 _f_0_0    = Float(f =_0_0)  # zero flattening
 _f__0_0   = Float(f_=_0_0)  # zero inverse flattening
@@ -1040,7 +1040,7 @@ class Ellipsoid(_NamedEnumItem):
                   _MODS.geodesicw._wrapped.Geodesic)
         except ImportError:
             pass
-        return t  # overwrite propertyROver
+        return t  # overwrite property_ROver
 
     @property_RO
     def geodesicw(self):
@@ -1523,7 +1523,7 @@ class Ellipsoid(_NamedEnumItem):
         '''(INTERNAL) Get all C{Rhumb...} classes, I{once}.
         '''
         p = _MODS.rhumb
-        return (p.aux_.RhumbAux,  # overwrite propertyROver
+        return (p.aux_.RhumbAux,  # overwrite property_ROver
                 p.ekx.Rhumb, p.solve.RhumbSolve)
 
     @property

pygeodesy/epsg.py

@@ -17,7 +17,7 @@ including coverage of UPS as zone C{0}.
 from pygeodesy.basics import isint, isstr, _xinstanceof
 from pygeodesy.errors import _ValueError
 from pygeodesy.interns import NN, _N_, _NS_, _S_, _SPACE_
-from pygeodesy.lazily import _ALL_LAZY, _ALL_OTHER
+from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY
 from pygeodesy.namedTuples import UtmUps2Tuple
 from pygeodesy.props import Property_RO
 from pygeodesy.streprs import Fmt
@@ -28,7 +28,7 @@ from pygeodesy.utmupsBase import _to3zBhp, _UPS_ZONE, _UTM_ZONE_MIN, \
                                  _UTM_ZONE_MAX, _UTMUPS_ZONE_INVALID
 
 __all__ = _ALL_LAZY.epsg
-__version__ = '24.05.18'
+__version__ = '24.08.05'
 
 # _EPSG_INVALID = _UTMUPS_ZONE_INVALID
 _EPSG_N_01 = 32601  # EPSG code for UTM zone 01 N
@@ -219,7 +219,7 @@ def encode(zone, hemipole=NN, band=NN):
     return e
 
 
-__all__ += _ALL_OTHER(decode2, encode)
+__all__ += _ALL_DOCS(decode2, encode)
 
 # **) MIT License
 #

pygeodesy/fmath.py

@@ -24,7 +24,7 @@ from math import fabs, sqrt  # pow
 import operator as _operator  # in .datums, .trf, .utm
 
 __all__ = _ALL_LAZY.fmath
-__version__ = '24.05.29'
+__version__ = '24.08.15'
 
 # sqrt(2) <https://WikiPedia.org/wiki/Square_root_of_2>
 _0_4142  =  0.41421356237309504880  # ... sqrt(2) - 1
@@ -886,6 +886,7 @@ def norm2(x, y):
               or zero norm.
     '''
     try:
+        h = None
         h = hypot(x, y)
         if h:
             x, y = (x / h), (y / h)

pygeodesy/formy.py

@@ -42,7 +42,7 @@ from contextlib import contextmanager
 from math import asin, atan, atan2, cos, degrees, fabs, radians, sin, sqrt  # pow
 
 __all__ = _ALL_LAZY.formy
-__version__ = '24.06.15'
+__version__ = '24.07.29'
 
 _RADIANS2 = (PI / _180_0)**2  # degrees- to radians-squared
 _ratio_   = 'ratio'
@@ -962,7 +962,7 @@ def hartzell(pov, los=False, earth=_WGS84, **name_LatLon_and_kwds):
                    B{C{datum}} if different and to convert from B{C{earth}}.
 
        @return: The intersection (L{Vector3d}, B{C{pov}}'s C{cartesian type} or the
-                given B{C{LatLon}} instance) with attribute C{heigth} set to the
+                given B{C{LatLon}} instance) with attribute C{height} set to the
                 distance to the B{C{pov}}.
 
        @raise IntersectionError: Invalid B{C{pov}} or B{C{pov}} inside the earth or

pygeodesy/fsums.py

@@ -47,7 +47,7 @@ from pygeodesy.streprs import Fmt, fstr, unstr
 from math import ceil as _ceil, fabs, floor as _floor  # PYCHOK used! .ltp
 
 __all__ = _ALL_LAZY.fsums
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 _add_op_      = _PLUS_  # in .auxilats.auxAngle
 _eq_op_       = _EQUAL_ * 2  # _DEQUAL_
@@ -1970,8 +1970,8 @@ class Fsum(_Named):  # sync __methods__ with .vector3dBase.Vector3dBase
     def signOf(self, res=True):
         '''Determine the sign of this instance.
 
-           @kwarg res: If C{True} consider, otherwise
-                       ignore the residual (C{bool}).
+           @kwarg res: If C{True}, consider, otherwise ignore
+                       the residual (C{bool}).
 
            @return: The sign (C{int}, -1, 0 or +1).
         '''
@@ -1992,7 +1992,7 @@ class Fsum(_Named):  # sync __methods__ with .vector3dBase.Vector3dBase
     def toStr(self, lenc=True, **prec_sep_fmt):  # PYCHOK signature
         '''Return this C{Fsum} instance as string.
 
-           @kwarg lenc: If C{True} include the current C{[len]} of this
+           @kwarg lenc: If C{True}, include the current C{[len]} of this
                         L{Fsum} enclosed in I{[brackets]} (C{bool}).
            @kwarg prec_sep_fmt: Optional keyword arguments for method
                        L{Fsum2Tuple.toStr}.