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

pygeodesy/geodesicw.py

@@ -8,8 +8,8 @@ that package is installed.
 The I{wrapped} class methods return a L{GDict} instance offering access to the C{dict} items
 either by C{key} or by C{attribute} name.
 
-With env variable C{PYGEODESY_GEOGRAPHICLIB} left undefined or set to C{"2"}, this module,
-L{pygeodesy.geodesicx} and L{pygeodesy.karney} will use U{GeographicLib 2.0
+With env variable C{PYGEODESY_GEOGRAPHICLIB} left undefined or set to C{"2"}, this module and modules
+L{pygeodesy.geodesici}, L{pygeodesy.geodesicx} and L{pygeodesy.karney} will use U{GeographicLib 2.0
 <https://GeographicLib.SourceForge.io/C++/doc/>} transcoding, otherwise C{1.52} or older.
 '''
 
@@ -18,17 +18,19 @@ from pygeodesy.constants import EPS, NAN, _EPSqrt as _TOL, _0_5
 from pygeodesy.datums import _earth_datum, _WGS84,  _EWGS84
 # from pygeodesy.dms import F_D  # from .latlonBase
 # from pygeodesy.ellipsoids import _EWGS84  # from .datums
-from pygeodesy.errors import IntersectionError, GeodesicError
+from pygeodesy.errors import _AssertionError, GeodesicError, \
+                              IntersectionError
 from pygeodesy.fsums import Fsum,  Fmt, unstr
 from pygeodesy.internals import _dunder_nameof, _under
 from pygeodesy.interns import NN, _DOT_, _SPACE_, _to_, _too_
 from pygeodesy.karney import _atan2d, Caps, Direct9Tuple, GDict, \
-                             _kWrapped, Inverse10Tuple
+                              Inverse10Tuple, _kWrapped
 from pygeodesy.latlonBase import LatLonBase as _LLB,  F_D, Radius_
 from pygeodesy.lazily import _ALL_LAZY, _ALL_MODS as _MODS
 from pygeodesy.named import callername, classname, _name1__, _name2__
 from pygeodesy.namedTuples import Destination3Tuple, Distance3Tuple
-from pygeodesy.props import Property, Property_RO, property_RO
+from pygeodesy.props import Property, Property_RO, property_RO, \
+                            property_ROver
 # from pygeodesy.streprs import Fmt, unstr  # from .fsums
 # from pygeodesy.units import Radius_  # from .latlonBase
 from pygeodesy.utily import _unrollon, _Wrap, wrap360,  fabs  # PYCHOK used!
@@ -37,7 +39,7 @@ from contextlib import contextmanager
 # from math import fabs  # from .utily
 
 __all__ = _ALL_LAZY.geodesicw
-__version__ = '24.06.24'
+__version__ = '24.07.12'
 
 _plumb_ = 'plumb'
 _TRIPS  =  65
@@ -48,14 +50,24 @@ class _gWrapped(_kWrapped):
         <https://PyPI.org/project/geographiclib>} classes.
     '''
 
-    @Property_RO  # MCCABE 24
+    @property_ROver  # MCCABE 24
     def Geodesic(self):
         '''Get the I{wrapped} C{geodesic.Geodesic} class from I{Karney}'s Python
            U{geographiclib<https://GitHub.com/geographiclib/geographiclib-python>},
            provided the latter is installed.
         '''
         _Geodesic = self.geographiclib.Geodesic
-        # assert Caps._STD == _Geodesic.STANDARD
+        if not (Caps.LATITUDE      == _Geodesic.LATITUDE and
+                Caps.LONGITUDE     == _Geodesic.LONGITUDE and
+                Caps.AZIMUTH       == _Geodesic.AZIMUTH and
+                Caps.DISTANCE      == _Geodesic.DISTANCE and
+                Caps.DISTANCE_IN   == _Geodesic.DISTANCE_IN and
+                Caps.REDUCEDLENGTH == _Geodesic.REDUCEDLENGTH and
+                Caps.GEODESICSCALE == _Geodesic.GEODESICSCALE and
+                Caps.AREA          == _Geodesic.AREA and
+                Caps.ALL           == _Geodesic.ALL):
+            raise _AssertionError(Caps=bin(Caps.ALL),
+                                  Geodesic=bin(_Geodesic.ALL))
 
         class Geodesic(_Geodesic):
             '''I{Wrapper} for I{Karney}'s Python U{geodesic.Geodesic
@@ -245,14 +257,16 @@ class _gWrapped(_kWrapped):
 
 #           Polygon = _Geodesic.Polygon
 
+            WGS84 = None  # _EWGS84.geodesicw recusion
+
         # Geodesic.ArcDirect.__doc__   = _Geodesic.ArcDirect.__doc__
         # Geodesic.Direct.__doc__      = _Geodesic.Direct.__doc__
         # Geodesic.Inverse.__doc__     = _Geodesic.Inverse.__doc__
         # Geodesic.InverseLine.__doc__ = _Geodesic.InverseLinr.__doc__
         # Geodesic.Line.__doc__        = _Geodesic.Line.__doc__
-        return Geodesic
+        return Geodesic  # overwrite property_ROver
 
-    @Property_RO  # MCCABE 16
+    @property_ROver  # MCCABE 16
     def GeodesicLine(self):
         '''Get the I{wrapped} C{geodesicline.GeodesicLine} class from I{Karney}'s
            Python U{geographiclib<https://GitHub.com/geographiclib/geographiclib-python>},
@@ -416,48 +430,61 @@ class _gWrapped(_kWrapped):
 
         # GeodesicLine.ArcPosition.__doc__ = _GeodesicLine.ArcPosition.__doc__
         # GeodesicLine.Position.__doc__    = _GeodesicLine.Position.__doc__
-        return GeodesicLine
+        return GeodesicLine  # overwrite property_ROver
 
-    @Property_RO
+    @property_ROver
     def Geodesic_WGS84(self):
         '''Get the I{wrapped} C{Geodesic(WGS84)} singleton, provided the
            U{geographiclib<https://PyPI.org/project/geographiclib>} package
            is installed, otherwise an C{ImportError}.
         '''
-        return _EWGS84.geodesic
+        return _EWGS84.geodesicw  # overwrite property_ROver
 
 _wrapped = _gWrapped()  # PYCHOK singleton, .ellipsoids, .test/base.py
 
 
-def Geodesic(a_ellipsoid=_EWGS84, f=None, **name):
-    '''Return a I{wrapped} C{geodesic.Geodesic} instance from I{Karney}'s
-       Python U{geographiclib<https://PyPI.org/project/geographiclib>},
-       provide the latter is installed, otherwise an C{ImportError}.
-
-       @arg a_ellipsoid: An ellipsoid (L{Ellipsoid}) or datum (L{Datum})
-              or the equatorial radius I{a} of the ellipsoid (C{meter}).
-       @arg f: The flattening of the ellipsoid (C{scalar}), required if
-               B{C{a_ellipsoid}}) is C{meter}, ignored otherwise.
-       @kwarg name: Optional C{B{name}=NN} (C{str}), ignored like B{C{f}}.
+class Geodesic(_gWrapped):  # overwritten by 1st instance
+    '''I{Wrapper} around I{Karney}'s class U{geographiclib.geodesic.Geodesic
+       <https://geographiclib.sourceforge.io/Python/doc/code.html>}.
     '''
-    return _wrapped.Geodesic(a_ellipsoid, f=f, **name)
-
-
-def GeodesicLine(geodesic, lat1, lon1, azi1, caps=Caps._STD_LINE):
-    '''Return a I{wrapped} C{geodesicline.GeodesicLine} instance from I{Karney}'s
-       Python U{geographiclib<https://PyPI.org/project/geographiclib>}, provided
-       the latter is installed, otherwise an C{ImportError}.
-
-       @arg geodesic: A I{wrapped} L{Geodesic} instance.
-       @arg lat1: Latitude of the first points (C{degrees}).
-       @arg lon1: Longitude of the first points (C{degrees}).
-       @arg azi1: Azimuth at the first points (compass C{degrees360}).
-       @kwarg caps: Optional, bit-or'ed combination of L{Caps} values specifying
-                    the capabilities the C{GeodesicLine} instance should possess,
-                    i.e., which quantities can be returned by methods
-                    C{GeodesicLine.Position} and C{GeodesicLine.ArcPosition}.
+    def __new__(unused, a_ellipsoid=_EWGS84, f=None, **name):
+        '''Return a I{wrapped} C{geodesic.Geodesic} instance from I{Karney}'s
+           Python U{geographiclib<https://PyPI.org/project/geographiclib>},
+           provide the latter is installed, otherwise an C{ImportError}.
+
+           @arg a_ellipsoid: An ellipsoid (L{Ellipsoid}) or datum (L{Datum})
+                  or the equatorial radius I{a} of the ellipsoid (C{meter}).
+           @arg f: The flattening of the ellipsoid (C{scalar}), required if
+                   B{C{a_ellipsoid}}) is C{meter}, ignored otherwise.
+           @kwarg name: Optional C{B{name}=NN} (C{str}).
+        '''
+        g = _wrapped.Geodesic(a_ellipsoid, f=f, **name)
+        _MODS.geodesicw.Geodesic = g.__class__  # overwrite class
+        return g
+
+
+class GeodesicLine(_gWrapped):  # overwritten by 1st instance
+    '''I{Wrapper} around I{Karney}'s class U{geographiclib.geodesicline.GeodesicLine
+       <https://geographiclib.sourceforge.io/Python/doc/code.html>}.
     '''
-    return _wrapped.GeodesicLine(geodesic, lat1, lon1, azi1, caps=caps)
+    def __new__(unused, geodesic, lat1, lon1, azi1, caps=Caps._STD_LINE, **name):
+        '''Return a I{wrapped} C{geodesicline.GeodesicLine} instance from I{Karney}'s
+           Python U{geographiclib<https://PyPI.org/project/geographiclib>}, provided
+           the latter is installed, otherwise an C{ImportError}.
+
+           @arg geodesic: A I{wrapped} L{Geodesic} instance.
+           @arg lat1: Latitude of the first points (C{degrees}).
+           @arg lon1: Longitude of the first points (C{degrees}).
+           @arg azi1: Azimuth at the first points (compass C{degrees360}).
+           @kwarg caps: Optional, bit-or'ed combination of L{Caps} values specifying
+                        the capabilities the C{GeodesicLine} instance should possess,
+                        i.e., which quantities can be returned by methods
+                        C{GeodesicLine.Position} and C{GeodesicLine.ArcPosition}.
+           @kwarg name: Optional C{B{name}=NN} (C{str}).
+        '''
+        gl = _wrapped.GeodesicLine(geodesic, lat1, lon1, azi1, caps=caps, **name)
+        _MODS.geodesicw.GeodesicLine = gl.__class__  # overwrite class
+        return gl
 
 
 def Geodesic_WGS84():
@@ -469,7 +496,7 @@ def Geodesic_WGS84():
 
 
 class _wargs(object):  # see also .formy._idllmn6, .latlonBase._toCartesian3, .vector2d._numpy
-    '''(INTERNAL) C{geographiclib} caller and exception mapper.
+    '''(INTERNAL) C{geographiclib} arguments and exception handler.
     '''
     @contextmanager  # <https://www.Python.org/dev/peps/pep-0343/> Examples
     def __call__(self, inst, *args, **kwds):
@@ -553,7 +580,7 @@ def _Intersecant2(gl, lat0, lon0, radius, tol=_TOL, form=F_D):  # MCCABE in LatL
 
 def _PlumbTo(gl, lat0, lon0, est=None, tol=_TOL):
     # (INTERNAL) Return the I{perpendicular} intersection of
-    # a geodesic from C{(lat0, lon0)} and a geodesic (line).
+    # a geodesic line C{gl} and geodesic from C{(lat0, lon0)}.
     pl = _MODS.rhumb.bases._PseudoRhumbLine(gl)
     return pl.PlumbTo(lat0, lon0, exact=gl.geodesic,
                                   est=est, tol=tol)

pygeodesy/geodesicx/__init__.py

@@ -23,7 +23,7 @@ from pygeodesy.karney import Caps, GeodesicError
 from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY
 
 __all__ = _ALL_LAZY.geodesicx + _ALL_DOCS(Caps, GeodesicError)
-__version__ = '24.06.19'
+__version__ = '24.07.09'
 
 # **) MIT License
 #

pygeodesy/geodesicx/gx.py

@@ -63,7 +63,7 @@ from pygeodesy.utily import atan2d as _atan2d_reverse, _unrollon, _Wrap, wrap360
 from math import atan2, copysign, cos, degrees, fabs, radians, sqrt
 
 __all__ = ()
-__version__ = '24.06.24'
+__version__ = '24.07.11'
 
 _MAXIT1 = 20
 _MAXIT2 = 10 + _MAXIT1 + MANT_DIG  # MANT_DIG == C++ digits
@@ -212,7 +212,7 @@ class GeodesicExact(_GeodesicBase):
                  <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1GeodesicExact.html>} and
                  Python U{Geodesic.ArcDirectLine<https://GeographicLib.SourceForge.io/Python/doc/code.html>}.
         '''
-        return self._GenDirectLine(lat1, lon1, azi1, True, a12, caps, **name)
+        return GeodesicLineExact(self, lat1, lon1, azi1, caps=caps, **name)._GenSet(self._debug, a12=a12)
 
     def Area(self, polyline=False, **name):
         '''Set up a L{GeodesicAreaExact} to compute area and
@@ -390,7 +390,7 @@ class GeodesicExact(_GeodesicBase):
                  <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1GeodesicExact.html>} and
                  Python U{Geodesic.DirectLine<https://GeographicLib.SourceForge.io/Python/doc/code.html>}.
         '''
-        return self._GenDirectLine(lat1, lon1, azi1, False, s12, caps, **name)
+        return GeodesicLineExact(self, lat1, lon1, azi1, caps=caps, **name)._GenSet(self._debug, s12=s12)
 
     def _dn(self, sbet, cbet):  # in gxline._GeodesicLineExact.__init__
         '''(INTERNAL) Helper.
@@ -497,7 +497,7 @@ class GeodesicExact(_GeodesicBase):
         Cs = Caps
         if self._debug:  # PYCHOK no cover
             outmask |= Cs._DEBUG_INVERSE & self._debug
-        outmask &= Cs._OUT_MASK  # incl. _SALPs_CALPs and _DEBUG_
+        outmask &= Cs._OUT_MASK  # incl. _SALP_CALPs_ and _DEBUG_
         # compute longitude difference carefully (with _diff182):
         # result is in [-180, +180] but -180 is only for west-going
         # geodesics, +180 is for east-going and meridional geodesics
@@ -505,8 +505,10 @@ class GeodesicExact(_GeodesicBase):
         # see C{result} from geographiclib.geodesic.Inverse
         if (outmask & Cs.LONG_UNROLL):  # == (lon1 + lon12) + lon12s
             r = GDict(lon1=lon1, lon2=fsumf_(lon1, lon12, lon12s))
-        else:
+        elif (outmask & Cs.LONGITUDE):
             r = GDict(lon1=_norm180(lon1), lon2=_norm180(lon2))
+        else:
+            r = GDict()
         if _K_2_0:  # GeographicLib 2.0
             # make longitude difference positive
             lon12, lon_ = _unsigned2(lon12)
@@ -535,7 +537,8 @@ class GeodesicExact(_GeodesicBase):
         # If really close to the equator, treat as on equator.
         lat1 = _around(_fix90(lat1))
         lat2 = _around(_fix90(lat2))
-        r.set_(lat1=lat1, lat2=lat2)
+        if (outmask & Cs.LATITUDE):
+            r.set_(lat1=lat1, lat2=lat2)
         # Swap points so that point with higher (abs) latitude is
         # point 1.  If one latitude is a NAN, then it becomes lat1.
         swap_ = fabs(lat1) < fabs(lat2) or isnan(lat2)
@@ -671,7 +674,7 @@ class GeodesicExact(_GeodesicBase):
                 S12 = -S12
             r.set_(S12=unsigned0(S12))
 
-        if (outmask & (Cs.AZIMUTH | Cs._SALPs_CALPs)):
+        if (outmask & (Cs.AZIMUTH | Cs._SALP_CALPs_)):
             if swap_:
                 salp1, salp2 = salp2, salp1
                 calp1, calp2 = calp2, calp1
@@ -683,7 +686,7 @@ class GeodesicExact(_GeodesicBase):
             if (outmask & Cs.AZIMUTH):
                 r.set_(azi1=_atan2d(salp1, calp1),
                        azi2=_atan2d_reverse(salp2, calp2, reverse=outmask & Cs.REVERSE2))
-            if (outmask & Cs._SALPs_CALPs):
+            if (outmask & Cs._SALP_CALPs_):
                 r.set_(salp1=salp1, calp1=calp1,
                        salp2=salp2, calp2=calp2)
 
@@ -707,25 +710,13 @@ class GeodesicExact(_GeodesicBase):
         r = self._GDictDirect(lat1, lon1, azi1, arcmode, s12_a12, outmask)
         return r.toDirect9Tuple()
 
-    def _GenDirectLine(self, lat1, lon1, azi1, arcmode, s12_a12, caps, **name):
-        '''(INTERNAL) Helper for C{ArcDirectLine} and C{DirectLine}.
-
-           @return: A L{GeodesicLineExact} instance.
-        '''
-        azi1 = _norm180(azi1)
-        # guard against underflow in salp0.  Also -0 is converted to +0.
-        s, c = _sincos2d(_around(azi1))
-        C    =  caps if arcmode else (caps | Caps.DISTANCE_IN)
-        return _GeodesicLineExact(self, lat1, lon1, azi1, C,
-                                  self._debug, s, c, **name)._GenSet(arcmode, s12_a12)
-
     def _GenInverse(self, lat1, lon1, lat2, lon2, outmask=Caps.STANDARD):
         '''(INTERNAL) The general I{Inverse} geodesic calculation.
 
            @return: L{Inverse10Tuple}C{(a12, s12, salp1, calp1, salp2, calp2,
                                              m12,   M12,   M21,   S12)}.
         '''
-        r = self._GDictInverse(lat1, lon1, lat2, lon2, outmask | Caps._SALPs_CALPs)
+        r = self._GDictInverse(lat1, lon1, lat2, lon2, outmask | Caps._SALP_CALPs_)
         return r.toInverse10Tuple()
 
     def _Inverse(self, ll1, ll2, wrap, **outmask):
@@ -770,7 +761,7 @@ class GeodesicExact(_GeodesicBase):
         # and .HeightIDWkarney._distances
         if wrap:
             _, lat2, lon2 = _Wrap.latlon3(lat1, lat2, lon2, True)  # _Geodesic.LONG_UNROLL
-        return fabs(self._GDictInverse(lat1, lon1, lat2, lon2, Caps._ANGLE_ONLY).a12)
+        return fabs(self._GDictInverse(lat1, lon1, lat2, lon2, Caps.EMPTY).a12)  # a12 always
 
     def Inverse3(self, lat1, lon1, lat2, lon2):  # PYCHOK outmask
         '''Return the distance in C{meter} and the forward and
@@ -815,11 +806,9 @@ class GeodesicExact(_GeodesicBase):
                  Python U{Geodesic.InverseLine<https://GeographicLib.SourceForge.io/Python/doc/code.html>}.
         '''
         Cs = Caps
-        r  = self._GDictInverse(lat1, lon1, lat2, lon2, Cs._SALPs_CALPs)  # No need for AZIMUTH
-        C  = (caps | Cs.DISTANCE) if (caps & (Cs.DISTANCE_IN & Cs._OUT_MASK)) else caps
-        azi1 = _atan2d(r.salp1, r.calp1)
-        return _GeodesicLineExact(self, lat1, lon1, azi1, C,  # ensure a12 is distance
-                                  self._debug, r.salp1, r.calp1, **name)._GenSet(True, r.a12)
+        r  = self._GDictInverse(lat1, lon1, lat2, lon2, caps | Cs._SALP_CALPs_)
+        return GeodesicLineExact(self, lat1, lon1, None, caps=caps, _s_calp1=(r.salp1, r.calp1),
+                                                            **name)._GenSet(self._debug, **r)
 
     def _InverseArea(self, _meridian, salp1, calp1,  # PYCHOK 9 args
                                       salp2, calp2,
@@ -1130,7 +1119,7 @@ class GeodesicExact(_GeodesicBase):
                  <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1GeodesicExact.html>}
                  and Python U{Geodesic.Line<https://GeographicLib.SourceForge.io/Python/doc/code.html>}.
         '''
-        return _GeodesicLineExact(self, lat1, lon1, azi1, caps, self._debug, **name)
+        return GeodesicLineExact(self, lat1, lon1, azi1, caps=caps, **name)._GenSet(self._debug)
 
     @Property_RO
     def n(self):
@@ -1250,8 +1239,8 @@ class GeodesicExact(_GeodesicBase):
 
            @return: C{GeodesicExact} (C{str}).
         '''
-        return self._instr(props=(GeodesicExact.ellipsoid,),
-                           C4order=self.C4order, **prec_sep_name)
+        t = GeodesicExact.caps, GeodesicExact.ellipsoid
+        return self._instr(props=t, C4order=self.C4order, **prec_sep_name)
 
 
 class GeodesicLineExact(_GeodesicLineExact):
@@ -1282,7 +1271,7 @@ class GeodesicLineExact(_GeodesicLineExact):
         if (caps & Caps.LINE_OFF):  # copy to avoid updates
             geodesic = geodesic.copy(deep=False, name=_UNDER_(NN, geodesic.name))
 #           _update_all(geodesic)
-        _GeodesicLineExact.__init__(self, geodesic, lat1, lon1, azi1, caps, 0, **name)
+        _GeodesicLineExact.__init__(self, geodesic, lat1, lon1, azi1, caps, **name)
 
 
 def _Astroid(x, y):

pygeodesy/geodesicx/gxline.py

@@ -38,8 +38,8 @@ from __future__ import division as _; del _  # PYCHOK semicolon
 
 # 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
-# from pygeodesy.errors import _xError  # _MODS
+                               _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, \
@@ -47,7 +47,8 @@ from pygeodesy.geodesicx.gxbases import _cosSeries, _GeodesicBase, \
 # 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, \
-                             _K_2_0, _norm2, _norm180, _sincos2, _sincos2d
+                             _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
@@ -55,7 +56,7 @@ from pygeodesy.utily import atan2d as _atan2d_reverse, sincos2
 from math import atan2, cos, degrees, fabs, floor, radians, sin
 
 __all__ = ()
-__version__ = '24.06.24'
+__version__ = '24.07.12'
 
 _glXs = []  # instances of C{[_]GeodesicLineExact} to be updated
 
@@ -92,23 +93,18 @@ class _GeodesicLineExact(_GeodesicBase):
 #   _somg1 = _comg1 = NAN
 #   _ssig1 = _csig1 = NAN
 
-    def __init__(self, gX, lat1, lon1, azi1, caps, _debug, *salp1_calp1, **name):
+    def __init__(self, gX, lat1, lon1, azi1, caps, **name_):
         '''(INTERNAL) New C{[_]GeodesicLineExact} instance.
         '''
-        _xGeodesicExact(gX=gX)
-        Cs = Caps
-        if _debug:  # PYCHOK no cover
-            self._debug |= _debug & Cs._DEBUG_ALL
-            # _CapsBase.debug._update(self)
-        if salp1_calp1:
-            salp1, calp1 = salp1_calp1
-        else:
+#       _xGeodesicExact(gX=gX)
+        if azi1 is None:  # see GeodesicExact.InverseLine
+            (salp1, calp1), name_ = _xkwds_pop2(name_, _s_calp1=(_0_0, _1_0))
+            azi1 = _atan2d(salp1, calp1)
+        else:  # guard against salp0 underflow, convert -0 to +0
             azi1 = _norm180(azi1)
-            # guard against salp0 underflow,
-            # also -0 is converted to +0
             salp1, calp1 = _sincos2d(_around(azi1))
-        if name:
-            self.name = name
+        if name_:
+            self.name = name_
 
         self._gX    = gX  # GeodesicExact only
         self._lat1  = lat1 = _fix90(lat1)
@@ -117,7 +113,7 @@ class _GeodesicLineExact(_GeodesicBase):
         self._salp1 = salp1
         self._calp1 = calp1
         # allow lat, azimuth and unrolling of lon
-        self._caps  = caps | Cs._LINE
+        self._caps  = caps | Caps._AZIMUTH_LATITUDE_LONG_UNROLL
 
         sbet1, cbet1 = _sinf1cos2d(_around(lat1), gX.f1)
         self._dn1 = gX._dn(sbet1, cbet1)
@@ -142,11 +138,11 @@ class _GeodesicLineExact(_GeodesicBase):
         self._ssig1, self._csig1 = _norm2(sbet1, c)  # sig1 in (-pi, pi]
         # _norm2(somg1, comg1)  # no need to normalize!
         # _norm2(schi1?, cchi1)  # no need to normalize!
-        if not (caps & Cs.LINE_OFF):
+        if not (caps & Caps.LINE_OFF):
             _glXs.append(self)
-        # no need to pre-compute other attrs based on _Caps.X.  All are
-        # Property_RO's, computed once and cached/memoized until reset
-        # when C4order is changed or Elliptic function reset is invoked.
+        # no need to pre-compute other attrs for (caps & Caps.X).  All are
+        # Property_RO's, computed once and cached/memoized until reset when
+        # arc, distance, C4order is changed or Elliptic function is reset.
 
     def __del__(self):  # XXX use weakref?
         if _glXs:  # may be empty or None
@@ -295,22 +291,18 @@ class _GeodesicLineExact(_GeodesicBase):
                     C{lon1}, C{azi1} and arc length C{a12} always included,
                     except when C{a12=NAN}.
         '''
-
-        r = GDict(a12=NAN, s12=NAN)  # note both a12 and s12, always
-        if not (arcmode or self._caps_DISTANCE_IN):  # PYCHOK no cover
-            return r  # Uninitialized or impossible distance requested
-
         Cs = Caps
-        if self._debug:  # PYCHOK no cover
-            outmask |= self._debug & Cs._DEBUG_DIRECT_LINE
-        outmask &= self._caps & Cs._OUT_MASK
-
+        if outmask:
+            outmask &= self._caps & Cs._OUT_MASK
         eF = self._eF
         gX = self.geodesic  # ._gX
+        r  = GDict(a12=NAN, s12=NAN)  # both a12 and s12, always
 
-        if arcmode:
-            # s12_a12 is spherical arc length
-            E2 = _0_0
+        if not isfinite(s12_a12):
+            # E2 = sig12 = ssig12 = csig12 = NAN
+            return r._toNAN(outmask)
+        elif arcmode:  # s12_a12 is (spherical) arc length
+            r.set_(a12=s12_a12)
             sig12 = radians(s12_a12)
             if _K_2_0:
                 ssig12, csig12 = sincos2(sig12)  # utily, no NEG0
@@ -319,31 +311,25 @@ class _GeodesicLineExact(_GeodesicBase):
                 a -= floor(a / _180_0) * _180_0  # 0 <= 0 < 180
                 ssig12 = _0_0 if a ==  0 else sin(sig12)
                 csig12 = _0_0 if a == 90 else cos(sig12)
-        else:  # s12_a12 is distance
+            E2 = _0_0
+        elif self._caps_DISTANCE_IN:  # s12_a12 is distance
             t = s12_a12 / self._E0b
             s, c = _sincos2(t)  # tau12
             # tau2 = tau1 + tau12
             E2 = -eF.deltaEinv(*_sincos12(-s, c, *self._stau1_ctau1))
             sig12 = fsum1f_(self._E1, -E2, t)  # == t - (E2 - E1)
             ssig12, csig12 = _sincos2(sig12)
-
-        salp0, calp0 = self._salp0, self._calp0
-        ssig1, csig1 = self._ssig1, self._csig1
+            r.set_(a12=degrees(sig12))
+        else:  # uninitialized or impossible distance requested
+            return r
 
         # sig2 = sig1 + sig12
-        ssig2, csig2 = _sincos12(-ssig12, csig12, ssig1, csig1)
-        dn2 = eF.fDelta(ssig2, csig2)
-        # sin(bet2) = cos(alp0) * sin(sig2) and
-        #    cbet2  = hypot(salp0, calp0 * csig2).  Alt:
-        #    cbet2  = hypot(csig2, salp0 * ssig2)
-        sbet2, cbet2 = _sin1cos2(calp0, salp0, csig2, ssig2)
-        if cbet2 == 0:  # salp0 = 0, csig2 = 0, break degeneracy
-            cbet2 = csig2 = _TINY
-        # tan(alp0) = cos(sig2) * tan(alp2)
-        salp2 = salp0
-        calp2 = calp0 * csig2  # no need to normalize
+        ssig1, csig1 =      self._ssig1, self._csig1
+        ssig2, csig2 = t = _sincos12(-ssig12, csig12, ssig1, csig1)
+        dn2 = eF.fDelta(*t)
 
-        if (outmask & Cs.DISTANCE):
+        if (outmask &  Cs.DISTANCE):
+            outmask ^= Cs.DISTANCE
             if arcmode:  # or f_0_01
                 E2 = eF.deltaE(ssig2, csig2, dn2)
                 # AB1 = _E0 * (E2 - _E1)
@@ -355,10 +341,34 @@ class _GeodesicLineExact(_GeodesicBase):
                 s12 = s12_a12
             r.set_(s12=s12)
 
+        if not outmask:  # all done, see ._GenSet
+            return r
+
+        if self._debug:  # PYCHOK no cover
+            outmask |= self._debug & Cs._DEBUG_DIRECT_LINE
+
         if (outmask & Cs._DEBUG_DIRECT_LINE):  # PYCHOK no cover
             r.set_(sig12=sig12, dn2=dn2, b=gX.b, e2=gX.e2, f1=gX.f1,
                    E0b=self._E0b, E1=self._E1, E2=E2, eFk2=eF.k2, eFa2=eF.alpha2)
 
+        # sin(bet2) = cos(alp0) * sin(sig2) and
+        #    cbet2  = hypot(salp0, calp0 * csig2).  Alt:
+        #    cbet2  = hypot(csig2, salp0 * ssig2)
+        salp0, calp0 =  self._salp0, self._calp0
+        sbet2, cbet2 = _sin1cos2(calp0, salp0, csig2, ssig2)
+        if cbet2 == 0:  # salp0 = 0, csig2 = 0, break degeneracy
+            cbet2 = csig2 = _TINY
+        # tan(alp0) = cos(sig2) * tan(alp2)
+        salp2 = salp0
+        calp2 = calp0 * csig2  # no need to normalize
+
+        if (outmask & Cs.AZIMUTH):
+            r.set_(azi2=_atan2d_reverse(salp2, calp2,
+                                reverse=outmask & Cs.REVERSE2))
+
+        if (outmask & Cs.LATITUDE):
+            r.set_(lat2=_atan2d(sbet2, gX.f1 * cbet2))
+
         if (outmask & Cs.LONGITUDE):
             schi1 = self._somg1
             cchi1 = self._cchi1
@@ -372,7 +382,7 @@ class _GeodesicLineExact(_GeodesicBase):
                 tchi2 = t * schi2
                 chi12 = t * fsum1f_(_a(ssig1, csig1), -_a(ssig2, csig2),
                                     _a(tchi2, cchi2), -_a(tchi1, cchi1), sig12)
-                lon2 = self.lon1 + degrees(chi12 - lam12)
+                lon2  = self.lon1 + degrees(chi12 - lam12)
             else:
                 chi12 = atan2(*_sincos12(schi1, cchi1, schi2, cchi2))
                 lon2 = _norm180(self._lon1_norm180 + _norm180(degrees(chi12 - lam12)))
@@ -381,12 +391,6 @@ class _GeodesicLineExact(_GeodesicBase):
                 r.set_(ssig2=ssig2, chi12=chi12, H0e2_f1=self._H0e2_f1,
                        csig2=csig2, lam12=lam12, H1=self._H1)
 
-        if (outmask & Cs.LATITUDE):
-            r.set_(lat2=_atan2d(sbet2, gX.f1 * cbet2))
-
-        if (outmask & Cs.AZIMUTH):
-            r.set_(azi2=_atan2d_reverse(salp2, calp2, reverse=outmask & Cs.REVERSE2))
-
         if (outmask & Cs._REDUCEDLENGTH_GEODESICSCALE):
             dn1 = self._dn1
             J12 = self._D0k2 * fsumf_(eF.deltaD(ssig2, csig2, dn2), -self._D1, sig12)
@@ -438,10 +442,9 @@ class _GeodesicLineExact(_GeodesicBase):
             S12 += gX.c2 * atan2(salp12, calp12)
             r.set_(S12=S12)
 
-        r.set_(a12=s12_a12 if arcmode else degrees(sig12),
+        r.set_(azi1=_norm180(self.azi1),
                lat1=self.lat1,  # == _fix90(lat1)
-               lon1=self.lon1 if (outmask & Cs.LONG_UNROLL) else self._lon1_norm180,
-               azi1=_norm180(self.azi1))
+               lon1=self.lon1 if (outmask & Cs.LONG_UNROLL) else self._lon1_norm180)
         return r
 
     def _GenPosition(self, arcmode, s12_a12, outmask):
@@ -453,14 +456,24 @@ class _GeodesicLineExact(_GeodesicBase):
         r = self._GDictPosition(arcmode, s12_a12, outmask)
         return r.toDirect9Tuple()
 
-    def _GenSet(self, arcmode, s13_a13):
+    def _GenSet(self, debug, s12=None, a12=None, **llz2):
         '''(INTERNAL) Aka C++ C{GenSetDistance}.
         '''
-        if arcmode:
-            self.SetArc(s13_a13)
-        else:
-            self.SetDistance(s13_a13)
-        return self  # for gx.GeodesicExact.InverseLine and -._GenDirectLine
+        Cs = Caps
+        if debug:  # PYCHOK no cover
+            self._debug |= debug & Cs._DEBUG_ALL
+            # _CapsBase.debug._update(self)
+        if s12 is None:
+            if a12 is None:  # see GeodesicExact.Line
+                return self
+            s12 = self._GDictPosition(True,  a12, outmask=Cs.DISTANCE).s12 if a12 else _0_0
+        elif a12 is None:
+            a12 = self._GDictPosition(False, s12,                   0).a12 if s12 else _0_0
+        self._s13   = s12
+        self._a13   = a12
+        self._caps |= Cs.DISTANCE | Cs.DISTANCE_IN
+        # _update_all(self)  # new, from GeodesicExact.*Line
+        return _llz2gl(self, **llz2)
 
     @Property_RO
     def geodesic(self):
@@ -498,7 +511,7 @@ class _GeodesicLineExact(_GeodesicBase):
         try:
             return _MODS.geodesicw._Intersecant2(self, lat0, lon0, radius, tol=tol)
         except (TypeError, ValueError) as x:
-            raise _MODS.errors._xError(x, lat0, lon0, radius, tol=_TOL)
+            raise _xError(x, lat0, lon0, radius, tol=_TOL)
 
     @Property_RO
     def _H0e2_f1(self):
@@ -594,8 +607,7 @@ class _GeodesicLineExact(_GeodesicBase):
                     the reference point or C{NAN}.
         '''
         if self._a13 != a13:
-            self._a13 = a13
-            self._s13 = self._GDictPosition(True, a13, Caps.DISTANCE).s12  # if a13 else _0_0
+            self._GenSet(0, a12=a13)
             _update_all(self)
         return self._s13
 
@@ -608,10 +620,9 @@ class _GeodesicLineExact(_GeodesicBase):
                     and the reference point or C{NAN}.
         '''
         if self._s13 != s13:
-            self._s13 = s13
-            self._a13 = self._GDictPosition(False, s13, 0).a12 if s13 else _0_0
+            self._GenSet(0, s12=s13)
             _update_all(self)
-        return self._a13  # NAN for GeodesicLineExact without Cap.DISTANCE_IN
+        return self._a13
 
     @Property_RO
     def _stau1_ctau1(self):
@@ -632,7 +643,7 @@ class _GeodesicLineExact(_GeodesicBase):
            @return: C{GeodesicLineExact} (C{str}).
         '''
         C = _GeodesicLineExact
-        t =  C.lat1, C.lon1, C.azi1, C.a13, C.s13, C.geodesic
+        t =  C.lat1, C.lon1, C.azi1, C.a13, C.s13, C.caps, C.geodesic
         return self._instr(props=t, **prec_sep_name)