pygeodesy 24.10.24__py2.py3-none-any.whl → 24.12.12__py2.py3-none-any.whl

pygeodesy/geodesicx/gxline.py

@@ -49,14 +49,13 @@ from pygeodesy.lazily import _ALL_DOCS, _ALL_MODS as _MODS
 from pygeodesy.karney import _around, _atan2d, Caps, GDict, _fix90, \
                              _K_2_0, _llz2gl, _norm2, _norm180, \
                              _sincos2, _sincos2d
-from pygeodesy.named import Property_RO, _update_all
-# from pygeodesy.props import Property_RO, _update_all  # from .named
-from pygeodesy.utily import atan2d as _atan2d_reverse, sincos2
+from pygeodesy.props import Property_RO, property_ROver, _update_all
+from pygeodesy.utily import atan2, atan2d as _atan2d_reverse, sincos2
 
-from math import atan2, cos, degrees, fabs, floor, radians, sin
+from math import cos, degrees, fabs, floor, radians, sin
 
 __all__ = ()
-__version__ = '24.07.12'
+__version__ = '24.11.24'
 
 _glXs = []  # instances of C{[_]GeodesicLineExact} to be updated
 
@@ -377,11 +376,11 @@ class _GeodesicLineExact(_GeodesicBase):
             lam12 = salp0 * self._H0e2_f1 * fsum1f_(eF.deltaH(ssig2, csig2, dn2),
                                                     -self._H1, sig12)
             if (outmask & Cs.LONG_UNROLL):
-                _a, t = atan2, _copysign_1_0(salp0)  # east-going?
+                t = _copysign_1_0(salp0)  # east-going?
                 tchi1 = t * schi1
                 tchi2 = t * schi2
-                chi12 = t * fsum1f_(_a(ssig1, csig1), -_a(ssig2, csig2),
-                                    _a(tchi2, cchi2), -_a(tchi1, cchi1), sig12)
+                chi12 = t * fsum1f_(atan2(ssig1, csig1), -atan2(ssig2, csig2),
+                                    atan2(tchi2, cchi2), -atan2(tchi1, cchi1), sig12)
                 lon2  = self.lon1 + degrees(chi12 - lam12)
             else:
                 chi12 = atan2(*_sincos12(schi1, cchi1, schi2, cchi2))
@@ -634,6 +633,13 @@ class _GeodesicLineExact(_GeodesicBase):
         # unnecessary because Einv inverts E
         # return -self._eF.deltaEinv(stau1, ctau1)
 
+    @property_ROver
+    def _toProps7(self):
+        '''(INTERNAL) 7-Tuple of C{toStr} properties.
+        '''
+        C = _GeodesicLineExact
+        return C.lat1, C.lon1, C.azi1, C.a13, C.s13, C.caps, C.geodesic
+
     def toStr(self, **prec_sep_name):  # PYCHOK signature
         '''Return this C{GeodesicLineExact} as string.
 
@@ -642,16 +648,14 @@ class _GeodesicLineExact(_GeodesicBase):
 
            @return: C{GeodesicLineExact} (C{str}).
         '''
-        C = _GeodesicLineExact
-        t =  C.lat1, C.lon1, C.azi1, C.a13, C.s13, C.caps, C.geodesic
-        return self._instr(props=t, **prec_sep_name)
+        return self._instr(props=self._toProps7, **prec_sep_name)
 
 
 __all__ += _ALL_DOCS(_GeodesicLineExact)
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/geodsolve.py

@@ -23,7 +23,7 @@ from pygeodesy.solveBase import _SolveGDictBase, _SolveGDictLineBase
 from pygeodesy.utily import _unrollon, _Wrap, wrap360
 
 __all__ = _ALL_LAZY.geodsolve
-__version__ = '24.10.14'
+__version__ = '24.11.02'
 
 
 class _GeodesicSolveBase(_SolveGDictBase):
@@ -181,15 +181,6 @@ class GeodesicSolve(_GeodesicSolveBase):
             ll2 = _unrollon(ll1, _Wrap.point(ll2))
         return self.InverseLine(ll1.lat, ll1.lon, ll2.lat, ll2.lon, **caps_name)
 
-#   def _InverseLine2(self, lat1, lon1, lat2, lon2, **caps_name):  # in .geodesici
-#       '''(INTERNAL) Helper for L{InverseLine} and L{_InverseLine}.
-#       '''
-#       r  = self.Inverse(lat1, lon1, lat2, lon2)
-#       gl = GeodesicLineSolve(self, lat1, lon1, r.azi1, **_name1__(caps_name, _or_nameof=self))
-#       gl._a13 = r.a12  # gl.SetArc(r.a12)
-#       gl._s13 = r.s12  # gl.SetDistance(r.s12)
-#       return gl, r
-
     def InverseLine(self, lat1, lon1, lat2, lon2, **caps_name):  # PYCHOK no cover
         '''Set up a L{GeodesicLineSolve} to compute several points
            on a single geodesic.
@@ -270,14 +261,14 @@ class GeodesicLineSolve(_GeodesicSolveBase, _SolveGDictLineBase):
         '''
         return self._a13
 
-    def Arc(self):
+    def Arc(self):  # PYCHOK no cover
         '''Return the arc length to reference point 3 (C{degrees} or C{NAN}).
 
            @see: Method L{SetArc} and property L{a13}.
         '''
         return self.a13
 
-    def ArcPosition(self, a12, outmask=Caps.STANDARD):  # PYCHOK unused
+    def ArcPosition(self, a12, outmask=Caps.STANDARD):  # PYCHOK no cover
         '''Find the position on the line given B{C{a12}}.
 
            @arg a12: Spherical arc length from the first point to the
@@ -347,7 +338,7 @@ class GeodesicLineSolve(_GeodesicSolveBase, _SolveGDictLineBase):
         '''
         return self._s13
 
-    def SetArc(self, a13):
+    def SetArc(self, a13):  # PYCHOK no cover
         '''Set reference point 3 in terms relative to the first point.
 
            @arg a13: Spherical arc length from the first to the reference
@@ -362,13 +353,13 @@ class GeodesicLineSolve(_GeodesicSolveBase, _SolveGDictLineBase):
 #           _update_all(self)
         return self._s13
 
-    def SetDistance(self, s13):
+    def SetDistance(self, s13):  # PYCHOK no cover
         '''Set reference point 3 in terms relative to the first point.
 
            @arg s13: Distance from the first to the reference point (C{meter}).
 
-           @return: The arc length C{a13} (C{degrees}) between the first
-                    and the reference point or C{NAN}.
+           @return: The arc length C{a13} (C{degrees}) between the first and
+                    the reference point or C{NAN}.
         '''
         if self._s13 != s13:
             self._s13 = s13
@@ -513,7 +504,7 @@ if __name__ == '__main__':
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/geohash.py

@@ -1099,7 +1099,7 @@ if __name__ == '__main__':
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/geoids.py

@@ -15,7 +15,7 @@ The L{GeoidG2012B} and L{GeoidPGM} interpolators both depend on U{scipy
 require those packages to be installed.
 
 In addition, each geoid interpolator needs C{grid knots} (down)loaded from
-a C{geoid} model file, I{specific to the interpolator}, more details below
+a C{geoid} model file, I{specific to the interpolator}.  More details below
 and in the documentation of the interpolator class.  For each interpolator,
 there are several interpolation choices, like I{linear}, I{cubic}, etc.
 
@@ -42,7 +42,7 @@ C{>>> h = ginterpolator(ll)}
 
 or
 
-C{>>> h0, h1, h2, ... = ginterpolator(ll0, ll1, ll2, ...)}
+C{>>> h1, h2, h3, ... = ginterpolator(ll1, ll2, ll3, ...)}
 
 or a list, tuple, generator, etc. of C{LatLon}s
 
@@ -118,7 +118,7 @@ except ImportError:  # Python 3+
     from io import BytesIO as _BytesIO  # PYCHOK expected
 
 __all__ = _ALL_LAZY.geoids
-__version__ = '24.10.11'
+__version__ = '24.11.05'
 
 _assert_         = 'assert'
 _bHASH_          = b'#'
@@ -159,7 +159,7 @@ class _GeoidBase(_HeightBase):
     _smooth   =  0      # used only for RectBivariateSpline
     _stdev    =  None   # fixed in GeoidKarney
     _u2B      =  0      # np.itemsize or undefined
-    _yx_hits  =  None   # cache hits, ala Karney
+    _yx_hits  =  None   # cache hits, ala Karney's
 
 #   _lat_d  = _0_0  # increment, +tive
 #   _lat_lo = _0_0  # lower lat, south
@@ -1621,7 +1621,7 @@ class _PGM(_Gpars):
 
 
 class PGMError(GeoidError):
-    '''Issue parsing or cropping an C{egm*.pgm} geoid dataset.
+    '''An issue while parsing or cropping an C{egm*.pgm} geoid dataset.
     '''
     pass
 
@@ -1837,7 +1837,7 @@ del _intCs  # trash ints cache
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/hausdorff.py

@@ -882,7 +882,7 @@ def randomrangenerator(seed):
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/heights.py

@@ -91,7 +91,7 @@ from pygeodesy.units import _isDegrees, Float_, Int_
 # from math import radians  # from .points
 
 __all__ = _ALL_LAZY.heights
-__version__ = '24.08.24'
+__version__ = '24.11.02'
 
 _error_  = 'error'
 _formy   = _MODS.into(formy=__name__)
@@ -1031,7 +1031,7 @@ class HeightIDWkarney(_HeightIDW):
        <https://WikiPedia.org/wiki/Inverse_distance_weighting>} (IDW) and the
        I{angular} distance in C{degrees} from I{Karney}'s U{geographiclib
        <https://PyPI.org/project/geographiclib>} method U{Geodesic.Inverse
-       <https://geographiclib.sourceforge.io/Python/doc/code.html#
+       <https://GeographicLib.SourceForge.io/Python/doc/code.html#
        geographiclib.geodesic.Geodesic.Inverse>}.
     '''
     def __init__(self, knots, beta=2, datum=None, **name__wrap):
@@ -1110,7 +1110,7 @@ __all__ += _ALL_DOCS(_HeightBase, _HeightIDW, _HeightNamed)
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/internals.py

@@ -7,7 +7,7 @@ u'''Mostly INTERNAL functions, except L{machine}, L{print_} and L{printf}.
 # from pygeodesy.errors import _AttributeError, _error_init, _UnexpectedError, _xError2  # _MODS
 from pygeodesy.interns import NN, _BAR_, _COLON_, _DASH_, _DOT_, _ELLIPSIS_, _EQUALSPACED_, \
                              _immutable_, _NL_, _pygeodesy_, _PyPy__, _python_, _QUOTE1_, \
-                             _QUOTE2_, _s_, _SPACE_, _sys, _UNDER_, _utf_8_
+                             _QUOTE2_, _s_, _SPACE_, _sys, _UNDER_
 from pygeodesy.interns import _COMMA_, _Python_  # PYCHOK used!
 # from pygeodesy.streprs import anstr, pairs, unstr  # _MODS
 
@@ -16,6 +16,7 @@ from pygeodesy.interns import _COMMA_, _Python_  # PYCHOK used!
 # import sys as _sys  # from .interns
 
 _0_0      =  0.0  # PYCHOK in .basics, .constants
+_100_0    =  100.0  # in .constants
 _arm64_   = 'arm64'
 _iOS_     = 'iOS'
 _macOS_   = 'macOS'
@@ -40,14 +41,14 @@ def _DUNDER_nameof_(*names__):  # in .errors._IsnotError
 
 
 def _Property_RO(method):
-    '''(INTERNAL) Can't I{recursively} import L{props.property_RO}.
+    '''(INTERNAL) Can't import L{props.Property_RO}, I{recursively}.
     '''
     name = _DUNDER_nameof(method)
 
-    def _del(inst, attr):  # PYCHOK no cover
-        delattr(inst, attr)  # force error
+    def _del(inst, *unused):  # PYCHOK no cover
+        inst.__dict__.pop(name, None)
 
-    def _get(inst, **unused):  # PYCHOK 2 vs 3 args
+    def _get(inst, *unused):  # PYCHOK 2 vs 3 args
         try:  # to get the cached value immediately
             v = inst.__dict__[name]
         except (AttributeError, KeyError):
@@ -69,7 +70,8 @@ class _MODS_Base(object):
 
     def __setattr__(self, attr, value):  # PYCHOK no cover
         e = _MODS.errors
-        t = _EQUALSPACED_(self._DOT_(attr), repr(value))
+        n = _DOT_(self.name, attr)
+        t = _EQUALSPACED_(n, repr(value))
         raise e._AttributeError(_immutable_, txt=t)
 
     @_Property_RO
@@ -84,7 +86,6 @@ class _MODS_Base(object):
         '''Get platform 2-list C{[bits, machine]}, I{once}.
         '''
         import platform as p
-
         m = p.machine()  # ARM64, arm64, x86_64, iPhone13,2, etc.
         m = m.replace(_COMMA_, _UNDER_)
         if m.lower() == 'x86_64':  # PYCHOK on Intel or Rosetta2 ...
@@ -99,30 +100,15 @@ class _MODS_Base(object):
 
     @_Property_RO
     def ctypes3(self):
-        '''Get 3-tuple C{(ctypes.CDLL, ._dlopen, .util.findlibrary)}, I{once}.
+        '''Get C{ctypes.CDLL}, C{find_library} and C{dlopen}, I{once}.
         '''
-        if _ismacOS():
-            from ctypes import CDLL, DEFAULT_MODE, _dlopen
-
-            def dlopen(name):
-                return _dlopen(name, DEFAULT_MODE)
-
-        else:  # PYCHOK no cover
-            from ctypes import CDLL
-            dlopen = _passarg
-
-        from ctypes.util import find_library
-        return CDLL, dlopen, find_library
+        import ctypes as c
+        from ctypes.util import find_library as f
 
-    @_Property_RO
-    def ctypes5(self):
-        '''Get 5-tuple C{(ctypes.byref, .c_char_p, .c_size_t, .c_uint, .sizeof)}, I{once}.
-        '''
-        from ctypes import byref, c_char_p, c_size_t, c_uint, sizeof  # get_errno
-        return byref, c_char_p, c_size_t, c_uint, sizeof
+        def dlopen(name):  # on macOS only
+            return c._dlopen(name, c.DEFAULT_MODE)
 
-    def _DOT_(self, name):  # PYCHOK no cover
-        return _DOT_(self.name, name)
+        return c.CDLL, f, (dlopen if _ismacOS() else None)
 
     @_Property_RO
     def errors(self):
@@ -143,15 +129,10 @@ class _MODS_Base(object):
         '''
         try:  # Pythonista only
             from platform import iOS_ver
-            return iOS_ver()
+            t = iOS_ver()
         except (AttributeError, ImportError):
-            return NN, (NN, NN, NN), NN
-
-    @_Property_RO
-    def libc(self):
-        '''Load C{libc.dll|dylib}, I{once}.
-        '''
-        return _load_lib('libc')
+            t = NN, (NN, NN, NN), NN
+        return t
 
     @_Property_RO
     def name(self):
@@ -161,13 +142,12 @@ class _MODS_Base(object):
 
     @_Property_RO
     def nix2(self):  # PYCHOK no cover
-        '''Get Linux 2-list C{[distro, version]}, I{once}.
+        '''Get Linux 2-tuple C{(distro, version)}, I{once}.
         '''
-        import platform as p
-
-        n, v = p.uname()[0], NN
+        from platform import uname
+        v, n = NN, uname()[0]  # [0] == .system
         if n.lower() == 'linux':
-            try:  # use distro only for Linux, not macOS, etc.
+            try:  # use distro only on Linux, not macOS, etc.
                 import distro  # <https://PyPI.org/project/distro>
                 _a = _MODS.streprs.anstr
                 v  = _a(distro.version())  # first
@@ -197,7 +177,6 @@ class _MODS_Base(object):
         '''Get 2-list C{[OS, release]}, I{once}.
         '''
         import platform as p
-
         _Nix, _ = _MODS.nix2
         # - mac_ver() returns ('10.12.5', ..., 'x86_64') on
         #   macOS and ('10.3.3', ..., 'iPad4,2') on iOS
@@ -217,26 +196,26 @@ class _MODS_Base(object):
             if v and n:
                 break
         else:
-            n = v = NN  # XXX AssertioError?
+            n = v = NN  # XXX AssertionError?
         return [n, v]
 
     @_Property_RO
     def _Popen_kwds2(self):
         '''(INTERNAL) Get C{subprocess.Popen} and C{-kwds}.
         '''
-        import subprocess as _sub
+        import subprocess as s
         kwds = dict(creationflags=0,  # executable=sys.executable, shell=True,
-                    stdin=_sub.PIPE, stdout=_sub.PIPE, stderr=_sub.STDOUT)
-        if _sys.version_info[:2] > (3, 6):
+                    stdin=s.PIPE, stdout=s.PIPE, stderr=s.STDOUT)
+        if _MODS.sys_version_info2 > (3, 6):
             kwds.update(text=True)
-        return _sub.Popen, kwds
+        return s.Popen, kwds
 
     @_Property_RO
     def Pythonarchine(self):
         '''Get 3- or 4-list C{[PyPy, Python, bits, machine]}, I{once}.
         '''
         v  =  _sys.version
-        l3 = [_Python_(v)] + self.bits_machine2
+        l3 = [_Python_(v)] + _MODS.bits_machine2
         pypy = _PyPy__(v)
         if pypy:  # PYCHOK no cover
             l3.insert(0, pypy)
@@ -270,23 +249,23 @@ def _caller3(up, base=True):  # in .lazily, .named
        for the caller B{C{up}} frames back in the Python call stack.
 
        @kwarg base: Use C{B{base}=False} for the fully-qualified file
-                     name, otherwise the base (module) name (C{bool}).
+                    name, otherwise the base (module) name (C{bool}).
     '''
     f  =  None
-    _f = _MODS.os.path.basename if base else _passarg
+    _b = _MODS.os.path.basename if base else _passarg
     try:
         f = _sys._getframe(up + 1)  # == inspect.stack()[up + 1][0]
         t = _MODS.inspect.getframeinfo(f)
-        t =  t.function, _f(t.filename), t.lineno
+        t =  t.function, _b(t.filename), t.lineno
 # or ...
         # f = _sys._getframe(up + 1)
         # c =  f.f_code
         # t = (c.co_name,  # caller name
-        #     _f(c.co_filename),  # file name .py
+        #     _b(c.co_filename),  # file name .py
         #      f.f_lineno)  # line number
 # or ...
         # t = _MODS.inspect.stack()[up + 1]  # (frame, filename, lineno, function, ...)
-        # t =  t[3], _f(t[1]), t[2]
+        # t =  t[3], _b(t[1]), t[2]
     except (AttributeError, IndexError, ValueError):
         # sys._getframe(1) ... 'importlib._bootstrap' line 1032,
         # may throw a ValueError('call stack not deep enough')
@@ -307,7 +286,7 @@ def _enquote(strs, quote=_QUOTE2_, white=NN):  # in .basics, .solveBase
     return strs
 
 
-def _fper(p, q, per=100.0, prec=1):
+def _fper(p, q, per=_100_0, prec=1):
     '''Format a percentage C{B{p} * B{per} / B{q}} (C{str}).
     '''
     return '%.*f%%' % (prec, (float(p) * per / float(q)))
@@ -335,7 +314,7 @@ def _headof(name):
 #     return (a == b) if _isPyPy() else (a is b)
 
 
-def _isAppleSi():
+def _isAppleSi():  # PYCHOK no cover
     '''(INTERNAL) Is this C{macOS on Apple Silicon}? (C{bool})
     '''
     return _ismacOS() and machine().startswith(_arm64_)
@@ -366,7 +345,7 @@ def _isNix():  # in test/bases
     return _MODS.nix2[0]
 
 
-def _isPyChecker():
+def _isPyChecker():  # PYCHOK no cover
     '''(INTERNAL) Is C{PyChecker} running? (C{bool}).
     '''
     # .../pychecker/checker.py --limit 0 --stdlib pygeodesy/<mod>/<name>.py
@@ -390,17 +369,19 @@ def _isWindows():  # in test/bases
 def _load_lib(name):
     '''(INTERNAL) Load a C{dylib}, B{C{name}} must startwith('lib').
     '''
-    # macOS 11+ (aka 10.16) no longer provides direct loading of
-    # system libraries.  As a result, C{ctypes.util.find_library}
-    # will not find any library, unless previously installed by a
-    # low-level dlopen(name) call (with the library base C{name}).
-    CDLL, dlopen, find_lib = _MODS.ctypes3
-
+    CDLL, find_lib, dlopen = _MODS.ctypes3
     ns = find_lib(name), name
-    if dlopen is not _passarg:  # _ismacOS()
+    if dlopen:
+        # macOS 11+ (aka 10.16) no longer provides direct loading of
+        # system libraries.  As a result, C{ctypes.util.find_library}
+        # will not find any library, unless previously installed by a
+        # low-level dlopen(name) call (with the library base C{name}).
         ns += (_DOT_(name, 'dylib'),
                _DOT_(name, 'framework'), _MODS.os.path.join(
                _DOT_(name, 'framework'),  name))
+    else:  # not macOS
+        dlopen = _passarg  # no-op
+
     for n in ns:
         try:
             if n and dlopen(n):  # pre-load handle
@@ -548,7 +529,7 @@ def _Pythonarchine(sep=NN):  # in .lazily, test/bases versions
 def _secs2str(secs):  # in .geoids, ../test/bases
     '''Convert a time in C{secs} to C{str}.
     '''
-    if secs < 100.0:  # _100_0
+    if secs < _100_0:
         unit = len(_SIsecs) - 1
         while 0 < secs < 1 and unit > 0:
             secs *= 1e3  # _1000_0
@@ -610,18 +591,18 @@ def _sizeof(obj, deep=True):
 
 
 def _sysctl_uint(name):
-    '''(INTERNAL) Get an unsigned int sysctl item by name, use on macOS ONLY!
+    '''(INTERNAL) Get an C{unsigned int sysctl} item by name, I{ONLY on macOS!}
     '''
-    libc = _MODS.libc
+    libc = _load_lib('libc') if _ismacOS() else None
     if libc:  # <https://StackOverflow.com/questions/759892/python-ctypes-and-sysctl>
-        byref, char_p, size_t, uint, sizeof = _MODS.ctypes5
-        n = name if str is bytes else bytes(name, _utf_8_)  # PYCHOK isPython2 = str is bytes
-        u = uint(0)
-        z = size_t(sizeof(u))
-        r = libc.sysctlbyname(char_p(n), byref(u), byref(z), None, size_t(0))
-    else:  # couldn't find or load 'libc'
+        import ctypes as c
+        n = c.c_char_p(_MODS.basics.str2ub(name))  # bytes(name, _utf_8_)
+        u = c.c_uint(0)
+        z = c.c_size_t(c.sizeof(u))
+        r = libc.sysctlbyname(n, c.byref(u), c.byref(z), None, c.c_size_t(0))  # PYCHOK attr
+    else:  # not macOS or couldn't find or load 'libc'=
         r = -2
-    return int(r if r else u.value)  # -1 ENOENT error, -2 no libc
+    return int(r if r else u.value)  # -1 ENOENT error, -2 no libc or not macOS
 
 
 def _tailof(name):
@@ -637,7 +618,7 @@ def _under(name):  # PYCHOK in .datums, .auxilats, .ups, .utm, .utmupsBase, ...
     return name if name.startswith(_UNDER_) else NN(_UNDER_, name)
 
 
-def _usage(file_py, *args, **opts_help):  # in .etm, .geodesici
+def _usage(file_py, *args, **opts_help):  # in .etm, .geodesici  # PYCHOK no cover
     '''(INTERNAL) Build "usage: python -m ..." cmd line for module B{C{file_py}}.
     '''
     if opts_help:
@@ -671,12 +652,12 @@ def _usage_argv(argv0, *args):
     o = _MODS.os
     m =  o.path.dirname(argv0)
     m =  m.replace(o.getcwd(), _ELLIPSIS_) \
-          .replace(o.sep, _DOT_).strip()
+          .replace(o.sep,      _DOT_).strip()
     b =  o.path.basename(argv0)
     b, x = o.path.splitext(b)
     if x == '.py' and not _is_DUNDER_main(b):
         m = _DOT_(m or _pygeodesy_, b)
-    p = NN(_python_, _sys.version_info[0])
+    p = NN(_python_, _MODS.sys_version_info2[0])
     return (p, '-m', _enquote(m)) + args
 
 
@@ -689,7 +670,7 @@ def _version2(version, n=2):
     return t[:n]
 
 
-def _version_info(package):  # in .Base.karney, .basics
+def _version_info(package):  # in .basics, .karney._kWrapped.Math
     '''(INTERNAL) Get the C{package.__version_info__} as a 2- or
        3-tuple C{(major, minor, revision)} if C{int}s.
     '''
@@ -713,14 +694,14 @@ def _version_ints(vs):
 
 
 def _versions(sep=_SPACE_):
-    '''(INTERNAL) Get pygeodesy, PyPy and Python versions, bits, machine and OS as C{7- or 8-list} or C{str}.
+    '''(INTERNAL) Get pygeodesy, PyPy and Python versions, bits, machine and OS as C{8- or 9-list} or C{str}.
     '''
     l7 = [_pygeodesy_, _MODS.version] + _Pythonarchine() + _osversion2()
     return sep.join(l7) if sep else l7  # 5- or 6-list
 
 
 __all__ = tuple(map(_DUNDER_nameof, (machine, print_, printf)))
-__version__ = '24.10.20'
+__version__ = '24.11.06'
 
 if _is_DUNDER_main(__name__):  # PYCHOK no cover
 
@@ -732,9 +713,12 @@ if _is_DUNDER_main(__name__):  # PYCHOK no cover
 
     _main()
 
+# % python3 -m pygeodesy.internals
+# pygeodesy 24.11.11 Python 3.13.0 64bit arm64 macOS 14.6.1 _isfrozen False isLazy 1
+
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/interns.py

@@ -217,7 +217,6 @@ _ellipsoidal_         = 'ellipsoidal'        # PYCHOK OK
 _encode_              = 'encode'             # PYCHOK OK
 _end_                 = 'end'                # PYCHOK OK
 _epoch_               = 'epoch'              # PYCHOK OK
-_eps_                 = 'eps'                # PYCHOK OK
 _EQUAL_          = Str_('=')                 # PYCHOK OK
 _EQUALSPACED_    = Str_(' = ')               # PYCHOK OK
 _Error_               = 'Error'              # PYCHOK OK
@@ -441,7 +440,7 @@ _LR_PAIRS  = {_LANGLE_:  _RANGLE_,
 
 __all__ = (_NN_,  # NOT MISSING!
             Str_.__name__)  # classes
-__version__ = '24.10.19'
+__version__ = '24.11.27'
 
 if __name__ == '__main__':
 
@@ -464,7 +463,7 @@ if __name__ == '__main__':
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/iters.py

@@ -527,7 +527,7 @@ __all__ += _ALL_DOCS(_BaseIter)
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),

pygeodesy/karney.py

@@ -64,7 +64,7 @@ Karney-based functionality
     <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1Intersect.html>} from I{GeographicLib 2.3+}
 
   - L{JacobiConformal} -- U{JacobiConformal
-    <https://geographiclib.sourceforge.io/C++/doc/classGeographicLib_1_1experimental_1_1JacobiConformal.html>}
+    <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1experimental_1_1JacobiConformal.html>}
 
   - L{KTransverseMercator} - U{TransverseMercator
     <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1TransverseMercator.html>}
@@ -165,7 +165,7 @@ from pygeodesy.utily import atan2d, sincos2d, tand, _unrollon,  fabs
 # from math import fabs  # from .utily
 
 __all__ = _ALL_LAZY.karney
-__version__ = '24.10.14'
+__version__ = '24.11.26'
 
 _2_4_       = '2.4'
 _K_2_0      = _getenv(_PYGEODESY(_xgeographiclib, 1), _2_)
@@ -1011,7 +1011,7 @@ def _tand(x):
     try:
         return _wrapped.Math.tand(x)
     except AttributeError:
-        return tand(x)
+        return tand(x)  # Error=None
 
 
 def _unroll2(lon1, lon2, wrap=False):  # see .ellipsoidalBaseDI._intersects2
@@ -1039,7 +1039,7 @@ __all__ += _ALL_DOCS(_CapsBase)
 
 # **) MIT License
 #
-# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
+# Copyright (C) 2016-2025 -- mrJean1 at Gmail -- All Rights Reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a
 # copy of this software and associated documentation files (the "Software"),