pygeodesy 25.5.5__py2.py3-none-any.whl → 25.5.28__py2.py3-none-any.whl

pygeodesy/geodesicx/gxarea.py

@@ -15,9 +15,9 @@ and licensed under the MIT/X11 License.  For more information, see the
 U{GeographicLib<https://GeographicLib.SourceForge.io>} documentation.
 '''
 # make sure int/int division yields float quotient
-from __future__ import division as _; del _  # PYCHOK semicolon
+from __future__ import division as _; del _  # noqa: E702 ;
 
-from pygeodesy.basics import isodd, unsigned0
+from pygeodesy.basics import _copysign, isodd, unsigned0
 from pygeodesy.constants import NAN, _0_0, _0_5, _720_0
 from pygeodesy.internals import printf, typename
 # from pygeodesy.interns import _COMMASPACE_  # from .lazily
@@ -31,19 +31,16 @@ from pygeodesy.props import Property, Property_RO, property_RO
 from math import fmod as _fmod
 
 __all__ = ()
-__version__ = '24.10.14'
+__version__ = '25.05.28'
 
 
 class GeodesicAreaExact(_NamedBase):
-    '''Area and perimeter of a geodesic polygon, an enhanced
-       version of I{Karney}'s Python class U{PolygonArea
-       <https://GeographicLib.SourceForge.io/html/python/
-       code.html#module-geographiclib.polygonarea>} using
-       the more accurate surface area.
-
-       @note: The name of this class C{*Exact} is a misnomer, see
-              I{Karney}'s comments at C++ attribute U{GeodesicExact._c2
-              <https://GeographicLib.SourceForge.io/C++/doc/
+    '''Area and perimeter of a geodesic polygon, an enhanced version of I{Karney}'s
+       Python class U{PolygonArea<https://GeographicLib.SourceForge.io/html/python/
+       code.html#module-geographiclib.polygonarea>} using the more accurate surface area.
+
+       @note: The name of this class C{*Exact} is a misnomer, see I{Karney}'s comments at
+              C++ attribute U{GeodesicExact._c2<https://GeographicLib.SourceForge.io/C++/doc/
               GeodesicExact_8cpp_source.html>}.
     '''
     _Area    =  None
@@ -140,36 +137,35 @@ class GeodesicAreaExact(_NamedBase):
 
     @Property_RO
     def area0x(self):
-        '''Get the ellipsoid's surface area (C{meter} I{squared}),
-           more accurate for very I{oblate} ellipsoids.
+        '''Get the ellipsoid's surface area (C{meter} I{squared}), more accurate
+           for very I{oblate} ellipsoids.
         '''
         return self.ellipsoid.areax  # not .area!
 
     area0 = area0x  # for C{geographiclib} compatibility
 
-    def Compute(self, reverse=False, sign=True):
+    def Compute(self, reverse=False, sign=True, polar=False):
         '''Compute the accumulated perimeter and area.
 
-           @kwarg reverse: If C{True}, clockwise traversal counts as a
-                           positive area instead of counter-clockwise
-                           (C{bool}).
-           @kwarg sign: If C{True}, return a signed result for the area if
-                        the polygon is traversed in the "wrong" direction
-                        instead of returning the area for the rest of the
-                        earth.
-
-           @return: L{Area3Tuple}C{(number, perimeter, area)} with the
-                    number of points, the perimeter in C{meter} and the
-                    area in C{meter**2}.  The perimeter includes the
-                    length of a final edge, connecting the current to
-                    the initial point, if this polygon was initialized
-                    with C{polyline=False}.  For perimeter only, i.e.
-                    C{polyline=True}, area is C{NAN}.
-
-           @note: Arbitrarily complex polygons are allowed.  In the case
-                  of self-intersecting polygons, the area is accumulated
-                  "algebraically".  E.g., the areas of the 2 loops in a
-                  I{figure-8} polygon will partially cancel.
+           @kwarg reverse: If C{True}, clockwise traversal counts as a positive area instead
+                           of counter-clockwise (C{bool}).
+           @kwarg sign: If C{True}, return a signed result for the area if the polygon is
+                        traversed in the "wrong" direction instead of returning the area for
+                        the rest of the earth.
+           @kwarg polar: Use C{B{polar}=True} if the polygon encloses a pole (C{bool}), see
+                         function L{ispolar<pygeodesy.points.ispolar>} and U{area of a polygon
+                         enclosing a pole<https://GeographicLib.SourceForge.io/C++/doc/
+                         classGeographicLib_1_1GeodesicExact.html#a3d7a9155e838a09a48dc14d0c3fac525>}.
+
+           @return: L{Area3Tuple}C{(number, perimeter, area)} with the number of points, the
+                    perimeter in C{meter} and the (signed) area in C{meter**2}.  The perimeter
+                    includes the length of a final edge, connecting the current to the initial
+                    point, if this polygon was initialized with C{polyline=False}.  For perimeter
+                    only, i.e. C{polyline=True}, area is C{NAN}.
+
+           @note: Arbitrarily complex polygons are allowed.  In the case of self-intersecting
+                  polygons, the area is accumulated "algebraically".  E.g., the areas of both
+                  loops in a I{figure-8} polygon will partially cancel.
 
            @note: More points and edges can be added after this call.
         '''
@@ -179,7 +175,7 @@ class GeodesicAreaExact(_NamedBase):
             a = NAN if self.polyline else p
         elif self._Area:
             r = self._Inverse(self.lat1, self.lon1, self.lat0, self.lon0)
-            a = self._reduced(r.S12, reverse, sign, r.xing)
+            a = self._reduced(r.S12, r.xing, n, reverse=reverse, sign=sign, polar=polar)
             p = self._Peri.Sum(r.s12)
         else:
             p = self._Peri.Sum()
@@ -279,7 +275,7 @@ class GeodesicAreaExact(_NamedBase):
         t = _COMMASPACE_.join(pairs(d, prec=10))
         printf('%s %s: %s (%s)', self.named2, n, t, callername(up=2))
 
-    def _reduced(self, S12, reverse, sign, xing):
+    def _reduced(self, S12, xing, n, reverse=False, sign=True, polar=False):
         '''(INTERNAL) Accumulate and reduce area to allowed range.
         '''
         a0 =  self.area0x
@@ -296,6 +292,8 @@ class GeodesicAreaExact(_NamedBase):
             a = A.Add(-a0)
         elif a <= -a0_:
             a = A.Add( a0)
+        if polar:  # see .geodesicw._gwrapped.Geodesic.Area
+            a = A.Add(_copysign(a0 * _0_5 * n, a))  # - if reverse or sign?
         return unsigned0(a)
 
     def Reset(self):
@@ -313,63 +311,54 @@ class GeodesicAreaExact(_NamedBase):
 
     Clear = Reset
 
-    def TestEdge(self, azi, s, reverse=False, sign=True):
+    def TestEdge(self, azi, s, **reverse_sign_polar):
         '''Compute the properties for a tentative, additional edge
 
            @arg azi: Azimuth at the current the point (compass C{degrees}).
            @arg s: Length of the edge (C{meter}).
-           @kwarg reverse: If C{True}, clockwise traversal counts as a
-                           positive area instead of counter-clockwise
-                           (C{bool}).
-           @kwarg sign: If C{True}, return a signed result for the area if
-                        the polygon is traversed in the "wrong" direction
-                        instead of returning the area for the rest of the
-                        earth.
+           @kwarg reverse_sign_polar: Optional C{B{reverse}=False}, C{B{sign}=True} and
+                          C{B{polar}=False} keyword arguments, see method L{Compute}.
 
            @return: L{Area3Tuple}C{(number, perimeter, area)}.
 
            @raise GeodesicError: No points.
         '''
-        n = self.num + 1
-        p = self._Peri.Sum(s)
-        if self.polyline:
-            a, r = NAN, None
-        elif n < 2:
-            raise GeodesicError(num=self.num)
+        r, n = None, self.num + 1
+        if n < 2:  # raise GeodesicError(num=self.num)
+            a = p = NAN  # like .test_Planimeter19
         else:
-            d  = self._Direct(azi, s)
-            r  = self._Inverse(d.lat2, d.lon2, self.lat0, self.lon0)
-            a  = self._reduced(d.S12 + r.S12, reverse, sign, d.xing + r.xing)
-            p += r.s12
+            p = self._Peri.Sum(s)
+            if self.polyline:
+                a  = NAN
+            else:
+                d  = self._Direct(azi, s)
+                r  = self._Inverse(d.lat2, d.lon2, self.lat0, self.lon0)
+                a  = self._reduced(d.S12 + r.S12, d.xing + r.xing, n, **reverse_sign_polar)
+                p += r.s12
         if self.verbose:  # PYCHOK no cover
             self._print(n, p, a, r, azi=azi, s=s)
         return Area3Tuple(n, p, a)
 
-    def TestPoint(self, lat, lon, reverse=False, sign=True):
+    def TestPoint(self, lat, lon, **reverse_sign_polar):
         '''Compute the properties for a tentative, additional vertex
 
            @arg lat: Latitude of the point (C{degrees}).
            @arg lon: Longitude of the point (C{degrees}).
-           @kwarg reverse: If C{True}, clockwise traversal counts as a
-                           positive area instead of counter-clockwise
-                           (C{bool}).
-           @kwarg sign: If C{True}, return a signed result for the area if
-                        the polygon is traversed in the "wrong" direction
-                        instead of returning the area for the rest of the
-                        earth.
+           @kwarg reverse_sign_polar: Optional C{B{reverse}=False}, C{B{sign}=True} and
+                          C{B{polar}=False} keyword arguments, see method L{Compute}.
 
            @return: L{Area3Tuple}C{(number, perimeter, area)}.
         '''
         r, n = None, self.num + 1
         if n < 2:
             p = _0_0
-            a = NAN if self.polyline else p
+            a =  NAN if self.polyline else p
         else:
             i = self._Inverse(self.lat1, self.lon1, lat, lon)
             p = self._Peri.Sum(i.s12)
             if self._Area:
                 r  = self._Inverse(lat, lon, self.lat0, self.lon0)
-                a  = self._reduced(i.S12 + r.S12, reverse, sign, i.xing + r.xing)
+                a  = self._reduced(i.S12 + r.S12, i.xing + r.xing, n, **reverse_sign_polar)
                 p += r.s12
             else:
                 a = NAN

pygeodesy/geodesicx/gxbases.py

@@ -9,7 +9,7 @@ U{GeographicLib<https://GeographicLib.SourceForge.io>} documentation.
 '''
 
 from pygeodesy.basics import isodd,  _MODS
-from pygeodesy.constants import _EPSmin as _TINY, _0_0
+from pygeodesy.constants import _EPSmin as _TINY, _0_0, isfinite
 from pygeodesy.errors import _or, _xkwds_item2
 from pygeodesy.fmath import hypot as _hypot
 # from pygeodesy.interns import _numpy_  # _MODS
@@ -20,7 +20,7 @@ from pygeodesy.karney import _CapsBase, GeodesicError, _2cos2x, \
 from math import fabs, ldexp as _ldexp
 
 __all__ = ()
-__version__ = '24.09.07'
+__version__ = '25.05.28'
 
 # valid C{nC4}s and C{C4order}s, see _xnC4 below
 _nC4s = {24: 2900, 27: 4032, 30: 5425}
@@ -147,6 +147,16 @@ def _sinf1cos2d(lat, f1):
     return sbet, (cbet if fabs(cbet) > _TINY else _TINY)
 
 
+def _toNAN(outmask, *args):
+    '''(INTERNAL) Is any C{arg} not finite?
+    '''
+    if (outmask & _CapsBase.NONFINITONAN):  # Caps.NONFINITONAN
+        for arg in args:
+            if not isfinite(arg):
+                return True
+    return False
+
+
 def _xnC4(**name_nC4):
     '''(INTERNAL) Validate C{C4order}.
     '''

pygeodesy/geodesicx/gxline.py

@@ -13,7 +13,7 @@ and licensed under the MIT/X11 License.  For more information, see the
 U{GeographicLib<https://GeographicLib.SourceForge.io>} documentation.
 '''
 # make sure int/int division yields float quotient
-from __future__ import division as _; del _  # PYCHOK semicolon
+from __future__ import division as _; del _  # noqa: E702 ;
 
 # A copy of comments from Karney's C{GeodesicLineExact.cpp}:
 #
@@ -37,13 +37,14 @@ from __future__ import division as _; del _  # PYCHOK semicolon
 # - s and c prefixes mean sin and cos
 
 # from pygeodesy.basics import _xinstanceof  # _MODS
-from pygeodesy.constants import NAN, _EPSqrt as _TOL, _0_0, _1_0, \
-                               _180_0, _2__PI, _copysign_1_0, isfinite
+from pygeodesy.constants import NAN, _EPSqrt as _TOL, \
+                               _0_0, _1_0, _180_0, _2__PI, \
+                               _copysign_1_0, isfinite
 from pygeodesy.errors import _xError, _xkwds_pop2
 from pygeodesy.fsums import fsumf_, fsum1f_
 from pygeodesy.geodesicx.gxbases import _cosSeries, _GeodesicBase, \
                                         _sincos12, _sin1cos2, \
-                                        _sinf1cos2d, _TINY
+                                        _sinf1cos2d, _TINY, _toNAN
 # from pygeodesy.geodesicw import _Intersecant2  # _MODS
 from pygeodesy.lazily import _ALL_DOCS, _ALL_MODS as _MODS
 from pygeodesy.karney import _around, _atan2d, Caps, GDict, _fix90, \
@@ -55,7 +56,7 @@ from pygeodesy.utily import atan2, atan2d as _atan2d_reverse, sincos2
 from math import cos, degrees, fabs, floor, radians, sin
 
 __all__ = ()
-__version__ = '25.04.12'
+__version__ = '25.05.28'
 
 _glXs = []  # instances of C{[_]GeodesicLineExact} to be updated
 
@@ -91,6 +92,7 @@ class _GeodesicLineExact(_GeodesicBase):
 #   _salp1 = _calp1 = NAN
 #   _somg1 = _comg1 = NAN
 #   _ssig1 = _csig1 = NAN
+#   _toNAN =  False
 
     def __init__(self, gX, lat1, lon1, azi1, caps, **name_):
         '''(INTERNAL) New C{[_]GeodesicLineExact} instance.
@@ -104,6 +106,7 @@ class _GeodesicLineExact(_GeodesicBase):
             salp1, calp1 = _sincos2d(_around(azi1))
         if name_:
             self.name = name_
+        self._toNAN = _toNAN(caps, lat1, lon1, azi1, salp1, calp1)
 
         self._gX    = gX  # GeodesicExact only
         self._lat1  = lat1 = _fix90(lat1)
@@ -297,9 +300,9 @@ class _GeodesicLineExact(_GeodesicBase):
         gX = self.geodesic  # ._gX
         r  = GDict(a12=NAN, s12=NAN)  # both a12 and s12, always
 
-        if not isfinite(s12_a12):
+        if self._toNAN or not isfinite(s12_a12):  # _toNAN(outmask, s12_a12)?
             # E2 = sig12 = ssig12 = csig12 = NAN
-            return r._toNAN(outmask)
+            return r._toNAN(outmask | Cs.NONFINITONAN)  # for backward compatibility
         elif arcmode:  # s12_a12 is (spherical) arc length
             r.set_(a12=s12_a12)
             sig12 = radians(s12_a12)

pygeodesy/geoids.py

@@ -87,7 +87,7 @@ courtesy of SBFRF.
       Above Mean Sea Level<https://Wiki.ROS.org/mavros>}.
 '''
 # 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 _isin, len2, min2, isodd, _splituple, \
                               ub2str as _ub2str
@@ -126,7 +126,7 @@ except ImportError:  # Python 3+
     from io import BytesIO as _BytesIO  # PYCHOK expected
 
 __all__ = _ALL_LAZY.geoids
-__version__ = '25.04.14'
+__version__ = '25.05.21'
 
 _assert_    = 'assert'
 _bHASH_     = b'#'
@@ -148,7 +148,7 @@ class GeoidError(HeightError):
 class _GeoidBase(_HeightBase):
     '''(INTERNAL) Base class for C{Geoid...}s.
     '''
-    _center   =  None   # (lat, lon, height)
+#   _center   =  None   # (lat, lon, height)
     _cropped  =  None
 #   _datum    = _WGS84  # from _HeightBase
     _egm      =  None   # open C{egm*.pgm} geoid file
@@ -297,7 +297,7 @@ class _GeoidBase(_HeightBase):
 
     @Property_RO
     def _center(self):
-        ''' Cache for method L{center}.
+        '''(INTERNAL) Cache for method L{center}.
         '''
         return self._llh3(favg(self._lat_lo, self._lat_hi),
                           favg(self._lon_lo, self._lon_hi))
@@ -355,7 +355,7 @@ class _GeoidBase(_HeightBase):
         # build grid axis, hi = lo + (n - 1) * d
         m, a = len2(frange(lo, n, d))
         if m != n:
-            raise LenError(self.__class__, grid=m, **{name: n})
+            raise LenError(type(self), grid=m, **{name: n})
         if d < 0:
             d, a = -d, list(reversed(a))
         a = self.numpy.array(a)
@@ -907,7 +907,7 @@ def _I(i):
     '''(INTERNAL) Cache a single C{int} constant.
     '''
     i = int(i)
-    return _intCs.setdefault(i, i)  # PYCHOK undefined due to del _intCs
+    return _intCs.setdefault(i, i)  # noqa: F821 del
 
 
 def _T(cs):

pygeodesy/hausdorff.py

@@ -75,8 +75,8 @@ from pygeodesy.interns import NN, _i_, _j_, _units_
 # from pygeodesy.iters import points2 as _points2  # from .points
 from pygeodesy.lazily import _ALL_LAZY, _ALL_MODS as _MODS, _FOR_DOCS
 from pygeodesy.named import _name2__, _Named, _NamedTuple, _Pass
-# from pygeodesy.namedTuples import PhiLam2Tuple  # from .points
-from pygeodesy.points import _distanceTo,  PhiLam2Tuple, points2 as _points2, radians
+from pygeodesy.namedTuples import PhiLam2Tuple
+from pygeodesy.points import _distanceTo,  points2 as _points2, radians
 from pygeodesy.props import Property, Property_RO, property_doc_, property_RO
 from pygeodesy.units import Float, Number_
 from pygeodesy import unitsBase as _unitsBase  # _Str_..., _xUnit, _xUnits
@@ -85,7 +85,7 @@ from pygeodesy import unitsBase as _unitsBase  # _Str_..., _xUnit, _xUnits
 from random import Random
 
 __all__ = _ALL_LAZY.hausdorff
-__version__ = '25.04.21'
+__version__ = '25.05.26'
 
 _formy = _MODS.into(formy=__name__)
 
@@ -101,7 +101,7 @@ class Hausdorff(_Named):
        be overloaded.
     '''
     _datum = _WGS84
-    _func  =  None  # formy function/property
+#   _func  =  None  # formy function/property
     _kwds  = {}     # func_ options
     _model = ()
     _seed  =  None
@@ -124,7 +124,7 @@ class Hausdorff(_Named):
            @raise HausdorffError: Insufficient number of B{C{point1s}} or an invalid
                                   B{C{point1}}, B{C{seed}} or B{C{units}}.
         '''
-        name, kwds = _name2__(**name__kwds)  # name__=self.__class__
+        name, kwds = _name2__(**name__kwds)  # name__=type(self)
         if name:
             self.name = name
 

pygeodesy/heights.py

@@ -69,7 +69,7 @@ C{>>> h1, h2, ... = hinterpolator.height_(lat1, lon1, lat2, lon2, ...)}
       Interpolation.
 '''
 # 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 isscalar, len2, map1, min2, _xnumpy, _xscipy
 from pygeodesy.constants import EPS, PI, PI_2, PI2, _0_0, _90_0, _180_0
@@ -92,7 +92,7 @@ from pygeodesy.units import _isDegrees, Float_, Int_
 # from math import radians  # from .points
 
 __all__ = _ALL_LAZY.heights
-__version__ = '25.04.21'
+__version__ = '25.05.26'
 
 _error_  = 'error'
 _formy   = _MODS.into(formy=__name__)
@@ -212,7 +212,7 @@ class _HeightNamed(_Named):  # in .geoids
             n, lats = len2(lats)
             m, lons = len2(lons)
             if n != m:  # format a LenError, but raise self._Error
-                e = LenError(self.__class__, lats=n, lons=m, txt=None)
+                e = LenError(type(self), lats=n, lons=m, txt=None)
                 raise self._Error(str(e))
             llis = [LLiC(*t, datum=d) for t in zip(lats, lons)]
         return llis
@@ -363,13 +363,13 @@ class _HeightBase(_HeightNamed):  # in .geoids
     def numpy(self):
         '''Get the C{numpy} module or C{None}.
         '''
-        return _xnumpy(self.__class__, 1, 9)  # overwrite property_ROver
+        return _xnumpy(type(self), 1, 9)  # overwrite property_ROver
 
     @property_ROver
     def scipy(self):
         '''Get the C{scipy} module or C{None}.
         '''
-        return _xscipy(self.__class__, 1, 2)  # overwrite property_ROver
+        return _xscipy(type(self), 1, 2)  # overwrite property_ROver
 
     @property_ROver
     def scipy_interpolate(self):

pygeodesy/internals.py

@@ -132,7 +132,7 @@ class _MODS_Base(object):
     def name(self):
         '''Get this name (C{str}).
         '''
-        return typename(self.__class__)
+        return typename(type(self))
 
     @_Property_RO
     def nix2(self):  # PYCHOK no cover
@@ -686,7 +686,7 @@ def _versions(sep=_SPACE_):
 
 
 __all__ = tuple(map(typename, (machine, print_, printf, typename)))
-__version__ = '25.04.14'
+__version__ = '25.05.26'
 
 if __name__ == _DMAIN_:
 

pygeodesy/interns.py

@@ -443,15 +443,15 @@ _LR_PAIRS  = {_LANGLE_:  _RANGLE_,
 
 __all__ = (_NN_,  # NOT MISSING!
             Str_.__name__)  # classes
-__version__ = '25.04.12'
+__version__ = '25.05.26'
 
 if __name__ == _DMAIN_:
 
-    def _main():
+    def _main(globalocals):
         from pygeodesy import itemsorted, printf
 
         t = b = 0
-        for n, v in itemsorted(locals(), asorted=False, reverse=True):
+        for n, v in itemsorted(globalocals, asorted=False, reverse=True):
             if n.endswith(_UNDER_) and n.startswith(_UNDER_) and \
                                    not n.startswith(_DUNDER_):
                 t += 1
@@ -459,10 +459,10 @@ if __name__ == _DMAIN_:
                 m  = n[1:-1]
                 if m != v and m.replace(_UNDER_, _SPACE_) != v:
                     printf('%4d: %s = %r', t, n, v)
-        n = len(locals())
+        n = len(globalocals)
         printf('%4d (%d) names, %s chars total, %.2f chars avg', t, n, b, float(b) / t, nl=1)
 
-    _main()
+    _main(globals())  # or locals()
 
 # **) MIT License
 #

pygeodesy/iters.py

@@ -26,7 +26,7 @@ from pygeodesy.units import Int, Radius
 from pygeodesy.utily import degrees2m, _Wrap,  _1_0
 
 __all__ = _ALL_LAZY.iters
-__version__ = '25.04.14'
+__version__ = '25.05.19'
 
 _items_        = 'items'
 _iterNumpy2len =  1  # adjustable for testing purposes

pygeodesy/karney.py

@@ -141,7 +141,7 @@ in C{pygeodesy} are based on I{Karney}'s post U{Area of a spherical polygon
 <https://MathOverflow.net/questions/97711/the-area-of-spherical-polygons>}, 3rd Answer.
 '''
 # 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 _copysign, _isin, isint, neg, unsigned0, \
                              _xgeographiclib, _zip
@@ -166,7 +166,7 @@ from pygeodesy.utily import atan2d, sincos2d, tand, _unrollon,  fabs
 # from math import fabs  # from .utily
 
 __all__ = _ALL_LAZY.karney
-__version__ = '25.04.14'
+__version__ = '25.05.28'
 
 _2_4_       = '2.4'
 _K_2_0      = _getenv(_PYGEODESY_ENV(typename(_xgeographiclib)[2:]), _2_)
@@ -240,6 +240,8 @@ class Caps(object):
 
        C{LONG_UNROLL} - unroll C{lon2} in method C{.Direct},
 
+       C{NONFINITONAN} - set all C{GDict} items to C{NAN} iff any argument is C{non-finite}.
+
        C{REDUCEDLENGTH} - compute the reduced length C{m12},
 
        C{REVERSE2} - reverse azimuth C{azi2} by 180 degrees,
@@ -274,7 +276,7 @@ class Caps(object):
 
     LINE_CAPS     =  STANDARD_LINE | REDUCEDLENGTH | GEODESICSCALE  # .geodesici only
     LONG_UNROLL   =  1 << 15  # unroll C{lon2} in .Direct and .Position
-#                 =  1 << 16  # unused
+    NONFINITONAN  =  1 << 16  # see method GDict._toNAN
     LINE_OFF      =  1 << 17  # Line without updates from parent geodesic or rhumb
     REVERSE2      =  1 << 18  # reverse C{azi2}
     ALL           =  0x7F80 | _CAP_ALL  # without LONG_UNROLL, LINE_OFF, REVERSE2 and _DEBUG_*
@@ -327,9 +329,12 @@ if _FOR_DOCS:  # PYCHOK force ...
 else:
     Caps = Caps()  # PYCHOK singleton
 
-_key2Caps = dict(a12 =Caps.DISTANCE,  # in GDict._unCaps
+_key2Caps = dict(a12 =Caps.DISTANCE,  # in GDict._toNAN, -._unCaps
+                 azi1=Caps.AZIMUTH,
                  azi2=Caps.AZIMUTH,
+                 lat1=Caps.LATITUDE,
                  lat2=Caps.LATITUDE,
+                 lon1=Caps.LONGITUDE,
                  lon2=Caps.LONGITUDE,
                  m12 =Caps.REDUCEDLENGTH,
                  M12 =Caps.GEODESICSCALE,
@@ -353,6 +358,7 @@ class _CapsBase(_NamedBase):  # in .auxilats, .geodesicx.gxbases
     LINE_OFF      = Caps.LINE_OFF
     LONGITUDE     = Caps.LONGITUDE
     LONG_UNROLL   = Caps.LONG_UNROLL
+    NONFINITONAN  = Caps.NONFINITONAN
     REDUCEDLENGTH = Caps.REDUCEDLENGTH
     STANDARD      = Caps.STANDARD
     STANDARD_LINE = Caps.STANDARD_LINE  # for geodesici
@@ -449,11 +455,14 @@ class GDict(ADict):  # XXX _NamedDict
         '''
         return self._toTuple(Inverse10Tuple, dflt)
 
-    def _toNAN(self, outmask):  # .GeodesicLineExact._GenPosition
+    def _toNAN(self, outmask):  # .GeodesicExact._GDistInverse, .GeodesicLineExact._GenPosition
         '''(INTERNAL) Convert this C{GDict} to all C{NAN}s.
         '''
-        d = dict((n, NAN) for n in GeodSolve12Tuple._Names_)
-        return self.set_(**d)._unCaps(outmask)
+        if (outmask & Caps.NONFINITONAN):
+            d = dict((k, NAN) for k, C in _key2Caps.items()
+                                       if (outmask & C) == C)
+            self.set_(**d)
+        return self
 
     @deprecated_method
     def toRhumb7Tuple(self, dflt=NAN):  # PYCHOK no cover
@@ -543,7 +552,7 @@ class Inverse10Tuple(_GTuple):
                                    **updates)  # PYCHOK indent
 
 
-class _kWrapped(object):  # in .geodesicw
+class _kWrapped(_CapsBase):  # in .geodesicw
     '''(INTERNAL) Wrapper for some of I{Karney}'s U{geographiclib
         <https://PyPI.org/project/geographiclib>} classes.
     '''
@@ -554,13 +563,15 @@ class _kWrapped(object):  # in .geodesicw
            <https://PyPI.org/project/geographiclib>} package is installed,
            otherwise raise a C{LazyImportError}.
         '''
-        g = _xgeographiclib(type(self).__module__, 1, 49)
+        g = _xgeographiclib(type(self), 1, 49)
         from geographiclib.geodesic import Geodesic
         g.Geodesic = Geodesic
         from geographiclib.geodesicline import GeodesicLine
         g.GeodesicLine = GeodesicLine
         from geographiclib.geomath import Math
         g.Math = Math
+#       from geographiclib.polygonarea import PolygonArea
+#       g.PolygonArea = PolygonArea  # see below
         return g
 
     @property_ROnce
@@ -586,6 +597,11 @@ class _kWrapped(object):  # in .geodesicw
         return (_2_4_ if _K_2_4 else
                (_2_   if _K_2_0 else _1_)) if self.Math else NN
 
+    @property_ROnce
+    def _PolygonArea(self):  # lazy import
+        from geographiclib.polygonarea import PolygonArea
+        return PolygonArea
+
 _wrapped = _kWrapped()  # PYCHOK singleton, .datum, .test/base.py
 
 
@@ -830,7 +846,7 @@ def _norm180(deg):  # mimick geomath.Math.AngNormalize
         return d
 
 
-def _polygon(geodesic, points, closed, line, wrap):
+def _polygon(geodesic, points, closed, line, wrap, polar):
     '''(INTERNAL) Compute the area or perimeter of a polygon,
         using a L{GeodesicExact}, L{GeodesicSolve} or (if the
         C{geographiclib} package is installed) a C{Geodesic}
@@ -848,7 +864,7 @@ def _polygon(geodesic, points, closed, line, wrap):
         if not closed:  # closed only
             raise _ValueError(closed=closed, points=_composite_)
 
-        return points._sum1(_a_p, closed, line, wrap)
+        return points._sum1(_a_p, closed, line, wrap, polar)
 
     gP = geodesic.Polygon(line)
     _A = gP.AddPoint
@@ -867,7 +883,7 @@ def _polygon(geodesic, points, closed, line, wrap):
         _A(p0.lat, p0.lon)
 
     # gP.Compute returns (number_of_points, perimeter, signed area)
-    return gP.Compute(False, True)[1 if line else 2]
+    return gP.Compute(reverse=False, sign=True, polar=polar)[1 if line else 2]
 
 
 try:

pygeodesy/ktm.py

@@ -40,7 +40,7 @@ and licensed under the MIT/X11 License.  For more information, see the
 U{GeographicLib<https://GeographicLib.SourceForge.io>} documentation.
 '''
 # make sure int/int division yields float quotient
-from __future__ import division as _; del _  # PYCHOK semicolon
+from __future__ import division as _; del _  # noqa: E702 ;
 
 from pygeodesy.basics import copysign0, _isin, isodd, neg, neg_, \
                             _reverange, _xinstanceof
@@ -66,7 +66,7 @@ from cmath import polar
 from math import asinh, cos, cosh, degrees, fabs, sin, sinh, sqrt, tanh
 
 __all__ = _ALL_LAZY.ktm
-__version__ = '25.04.14'
+__version__ = '25.05.12'
 
 
 class KTMError(_ValueError):