pygeodesy 24.6.9__py2.py3-none-any.whl → 24.7.7__py2.py3-none-any.whl

{PyGeodesy-24.6.9.dist-info → PyGeodesy-24.7.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyGeodesy
-Version: 24.6.9
+Version: 24.7.7
 Summary: Pure Python geodesy tools
 Home-page: https://GitHub.com/mrJean1/PyGeodesy
 Author: Jean M. Brouwers
@@ -159,7 +159,7 @@ and McCabe_ using Python 2.7.18 and with Flake8_ using Python 3.11.5, both in 64
 
 For a summary of all *Karney*-based functionality in ``pygeodesy``, see module karney_.
 
-*Last updated: June 09, 2024.*
+*Last updated: July 07, 2024.*
 
 License
 =======

PyGeodesy-24.7.7.dist-info/RECORD

@@ -0,0 +1,117 @@
+pygeodesy/LICENSE,sha256=YfgAiyxOwY6P9Kkb1_5XN81nueTLrpb3Ffkv3EuPgFU,1144
+pygeodesy/__init__.py,sha256=Ig2DWbIX8WlxpVNviEhbft-iQ2xgVWvnOmbGWrpvV8c,41787
+pygeodesy/__main__.py,sha256=VWxepzxGqR5wsHYyIHFSsRMlZ27keX3xyEhBuGDRXxk,4727
+pygeodesy/albers.py,sha256=JXqeWAteV2N601e5R-D7bCsa8qAYv3oWm7M3R4uszXM,31078
+pygeodesy/azimuthal.py,sha256=5tMMKlzKyfGnreOHChrquBi241ZvIOBTUn_pbZCIJWc,50231
+pygeodesy/basics.py,sha256=mSim8pSrRLMFYTnTrJDvkthfrw2MWBmMya3hOHWX4co,29785
+pygeodesy/booleans.py,sha256=5IeA6QWihiPWSv2JnCbMT53ey1WYIU7od5VQ1YUFqX8,73529
+pygeodesy/cartesianBase.py,sha256=WaAod_-nwgX8MjNhu4rr_V9PmEaI0F8gKPCUH4-Olyc,46968
+pygeodesy/clipy.py,sha256=3ysIEWQ89HjvLnSlZm0nZAt9EN5AQxIs1sLLM8yF9zM,27675
+pygeodesy/constants.py,sha256=-weWOuHwE-qI6pYRLcTucI0KNcNJm6vPNzxwrJzACKs,19192
+pygeodesy/css.py,sha256=B_EKq757XdQSUy83HAxEf3H5Iyd7mw3DbJB5Wi3obAc,25651
+pygeodesy/datums.py,sha256=-m9-cvUVOaJ92eeFgc3O54lel3WqnVYcS7o6WCXkNyw,34043
+pygeodesy/dms.py,sha256=QxiRtyc8QSiW-egm6Mrcrgmi_deWz3YnYwIm82JS4TU,44443
+pygeodesy/ecef.py,sha256=yRydxBDiyvfrTTrQLawo-x2eGNcbd8CNQjBWfd3oSI8,59677
+pygeodesy/elevations.py,sha256=4FuVcVNb_D09gmcvUlck344N4f7Jms76SIRrdutvKjk,10801
+pygeodesy/ellipsoidalBase.py,sha256=olFcHvMeoW8Z_0T-Bn3XOpGGatoluaOZ50Fzm-ByAVg,55126
+pygeodesy/ellipsoidalBaseDI.py,sha256=OxbSBntV9xiOgsb-0un0cUYIVoPiIiH-lt3baBkbaS8,38400
+pygeodesy/ellipsoidalExact.py,sha256=GnSMNVnSG4VyORMcQZKxpA-R6HA0gWbTBkEIg1qrVaE,16945
+pygeodesy/ellipsoidalGeodSolve.py,sha256=CqdNNqdwuUNIwZvYVMsk3rnW0U3KMgEoSQj_VIcFBEI,16665
+pygeodesy/ellipsoidalKarney.py,sha256=XIvmSmMt0CGd0LtXxcDHX3KXXR2Mn8cRukefNQErJFU,18720
+pygeodesy/ellipsoidalNvector.py,sha256=BbCWTZr9he3ayC8YEtLRXWVJ-g4HqHBuTVJsM33JKhw,30038
+pygeodesy/ellipsoidalVincenty.py,sha256=gsUFMKgqMZKT02jDm7TEJ_jSHX8d-KJCz91iCfku5kg,25951
+pygeodesy/ellipsoids.py,sha256=fraKj3NPStXablvzejt-LgQsghcp-MgMUvU6nh4L2YI,108034
+pygeodesy/elliptic.py,sha256=-80MbZvRPk-TeA_ggkfXhjuPv07MzsB4HxNF7gbdhB4,42501
+pygeodesy/epsg.py,sha256=oWHX_QVChE5roktAyXUmPmX49XHiryYmXTHxQzrAprE,8222
+pygeodesy/errors.py,sha256=-UnQ1GhkiTR6uBd0z0vd_pFEmjWXlOESRDwMdxY_JD0,30605
+pygeodesy/etm.py,sha256=y3dAqS-iWnbWzmsu4zB7kryAp_I17XEdzNRRk0klTww,44696
+pygeodesy/fmath.py,sha256=EOHD0uZ8VULZtXAk8tVeuPaSTozPDCN8GJcemCo-jqg,33709
+pygeodesy/formy.py,sha256=ZpPaQBQvaFiA-UcrgaiiV_iGxlfTqNdlR1Ngx-1oinY,75032
+pygeodesy/frechet.py,sha256=F6TYbOEYSOFcll6nvp4GhqafUWXh1umAKb1QaMYQtuM,34372
+pygeodesy/fstats.py,sha256=4eIhzSCMnn-2nVP3Q-5cCWCI-rvH0CE-zkk9hp3Pvn8,28642
+pygeodesy/fsums.py,sha256=LzsPQHY3bByOFFXPSo7E8lbYKWy5cif02WJk2JfnMvA,80455
+pygeodesy/gars.py,sha256=gJKZuGPKw8rlRLx1hywZrpGucpHXLvMe8fr8izgSW2s,11370
+pygeodesy/geodesici.py,sha256=SiC7GX1d3rswXL24kuxs6acxMx95lxgIZkhCJ_W0MKA,69988
+pygeodesy/geodesicw.py,sha256=apDkq2MwLCuEccRx39_P2vSqkW8aFaHX-aigj3fbU8Q,27186
+pygeodesy/geodsolve.py,sha256=luJCtc5pfNoSSKZ-OgXIMUjgRH2jo8skskvsy2sAJRA,23171
+pygeodesy/geohash.py,sha256=rOOGOHcTnxIPX2p5ieA1gQ_ZcRlUxjIcroPHa7a85ak,31876
+pygeodesy/geoids.py,sha256=oxn0MSgbvwBkrwyg1vS7PhhYZ_zbjLxC50W-8FTIxeU,80680
+pygeodesy/hausdorff.py,sha256=-aKtRbMefDSoIk4V3wCvNrXPZ7Bqk1P6-XuGuI7o8Zc,34770
+pygeodesy/heights.py,sha256=9kvyJj0-D3syZMdHNDXIfZT3MyhHH2fcqW_y-u7Tn2M,43197
+pygeodesy/internals.py,sha256=YUcf9wWXT7XztviEBN2uBww8Bt7gnqks2sAZt7k_j3w,20426
+pygeodesy/interns.py,sha256=kReVkCWA_rw8GyaYFVRI9dfdXu7MF9nD1MgoXsdsK7I,23273
+pygeodesy/iters.py,sha256=xPH0ytomvJeKHu717Fjzi3QbRrEikO6n7vqkY_IDz1k,20311
+pygeodesy/karney.py,sha256=e11p40pfXocdmFpVROjv4NTowxjAmL4bNeNTDmF095I,37745
+pygeodesy/ktm.py,sha256=u0xjvqhG2k18jg7bNclRr3D9umiZXKXQGRjmL_VX4yY,27437
+pygeodesy/latlonBase.py,sha256=M-Xe4KK8aOnQUxNJkODlTa5ApzhqXCggc_d8HlMdnIc,78987
+pygeodesy/lazily.py,sha256=HCrqdp_ZT_aTREO47nmlOch5kNHyL0IOfij40HL5hig,46842
+pygeodesy/lcc.py,sha256=oDooTzFHnqsMtSKmmmfEbypHpdlPltfo7Mt0pAO4-_A,25669
+pygeodesy/ltp.py,sha256=gQLZwcSIiXJrbRlaWnxAX8AK2VzH9l3jDqoNb3jcVD4,50773
+pygeodesy/ltpTuples.py,sha256=r3uHMBCxr31IsCMp_OtpevQPmULJhucn8JZ2bGjuiVI,58338
+pygeodesy/mgrs.py,sha256=w50bvM3qDtHDBDBRQ_EgZnPn7vxVXgoFnleeZgefkVk,29679
+pygeodesy/named.py,sha256=_2zgvL0cPg2JL3JpyWMZ7cc9e_I0y_4XPVYb2e7zEZg,52243
+pygeodesy/namedTuples.py,sha256=UDmL4kCihvf8tIUVXzGzRLzL_1BLuyqm04pite6YUuk,28495
+pygeodesy/nvectorBase.py,sha256=7BvbRQbtTpDsE7BMHt3vpbuCQZUV_k79HvygbG7ak10,28683
+pygeodesy/osgr.py,sha256=O8mLlmnQkcyXU4xczLGD1zhSyt8RQ3EsXctUnCIjO8U,30819
+pygeodesy/points.py,sha256=GirmbiqjD7Q0Z4SDySQO__Jgun-i8vMdJ81U2Kz8V0w,64408
+pygeodesy/props.py,sha256=8dGmTpdEABnLbBngmaOIpM0h4NYiBteMOHc_r4iNpAg,21988
+pygeodesy/resections.py,sha256=nkfBxYrsEdyq2JqAbPrRWKplJBzFkIXLvEZGB4gPu_A,43550
+pygeodesy/simplify.py,sha256=NybC-pfze0ObEm4ZCz6ZQrjJlQ-QyA83E6mSJqCuKq4,25223
+pygeodesy/solveBase.py,sha256=SRxXd7M3e3VCe9om5XEYuIJ_AoDlP26AnRzDuDbIgUs,18726
+pygeodesy/sphericalBase.py,sha256=YvjMZmmfy9pZeKHbY-ca0oi-Jy-OxsG9dhefy5LTjRA,32237
+pygeodesy/sphericalNvector.py,sha256=MiWcCy5CdvXsCa3963GeUMEnSYGhBiXzkoAEX_tGX4Q,56952
+pygeodesy/sphericalTrigonometry.py,sha256=Jf3FUUYEWXbNkiagr0HyMJ6E-cNghnTjcdgntTm28RE,64076
+pygeodesy/streprs.py,sha256=xudQ6zi5jFT_CmstSPysjxpZKyLBQNkUk1ETh0uvQ04,23030
+pygeodesy/trf.py,sha256=CRFHmu0lFNtc41fddXavEkHmgnTFWEqR4RTFodcFKsw,119022
+pygeodesy/triaxials.py,sha256=SLAlzdpOa8kFSkpP-lhL-swzsZkuqufZET_gJtoA_54,62750
+pygeodesy/units.py,sha256=mTn0APS0SW9fKn3IYf5usV63Xaw2B9DzkwefPNVu-Es,34607
+pygeodesy/unitsBase.py,sha256=yT7dgfwxtd1hHEn02NwPAdStsVWDfPH-Qdfrhvje7Yw,14057
+pygeodesy/ups.py,sha256=zapIvzoVuj_FDGC6sr8O8ynPhfqXwUg-EFCVnJdM9Eo,23329
+pygeodesy/utily.py,sha256=Zb6L9unzHHhp67znmQLLdizvyX6p4eczR1PDtcyWH-s,36189
+pygeodesy/utm.py,sha256=lCp7mNEaJNrAYnbdPaNUKkhbsX_GdssTEkp68uYdMLI,31091
+pygeodesy/utmups.py,sha256=g2Z_aEOt6fhV9f4fASlW4_K_O_P4zBsBbWfQV11mIKo,13196
+pygeodesy/utmupsBase.py,sha256=TJJeHSASjggUpzdpxwrOTH1tfHvDBxly47GJL27D8zY,18729
+pygeodesy/vector2d.py,sha256=zJq5PB777_mFJpKD-rt_T0Vm4SNbVwF7pc3KxX8uCT8,34994
+pygeodesy/vector3d.py,sha256=uDNnYSj4BL_Nec6SkyxXDbYaNjvI15HQX0xh25dRLI8,44883
+pygeodesy/vector3dBase.py,sha256=Om0Uq1zgjuJ6slj12KiFus_tobjYTPxgVZejNd0YzFI,35729
+pygeodesy/webmercator.py,sha256=stO_thswe_D4uxXWH43YWSN6-WWWpv_uIuOwvBIp8Ug,14932
+pygeodesy/wgrs.py,sha256=k2OhMue84yH_xaezo0sdxL1-X7fZRqZZ4-Rl1reDYSM,14792
+pygeodesy/auxilats/_CX_4.py,sha256=U41njj8Pu8cHMGuoUUVA20QIvRJAq-VGCnyoKJl0Ylo,8662
+pygeodesy/auxilats/_CX_6.py,sha256=x4hrHxunjqqkEsZbVW1dyn3R5mR8EWYOuX77RzDEyh4,14856
+pygeodesy/auxilats/_CX_8.py,sha256=t-OO48t4cCOsOgMi1FoyPw2DQqybVZFsgQMqAYP-jKY,25304
+pygeodesy/auxilats/__init__.py,sha256=YNp41rRC5DmAhBx4RPqoqh4yxD9Vjf9Wk_USwqeZYcE,2881
+pygeodesy/auxilats/__main__.py,sha256=Vuj1YSp1LV0zejVzi6EYauka1Dv8kwOHI_aeHxQEVYk,2899
+pygeodesy/auxilats/auxAngle.py,sha256=8Gsae1URFCfD6t0oNI1ZJmgtik_EOvSAwrNmAZSMm2I,16729
+pygeodesy/auxilats/auxDLat.py,sha256=3sq7Wc-ykpVbldNh10IZ3tIlJ7DcQFDlmZ4nOhJEgo0,10969
+pygeodesy/auxilats/auxDST.py,sha256=bdNEh3TdABWH7qW6ngZx5SnzDM3B5rtPLvYhvCnFsKc,10497
+pygeodesy/auxilats/auxLat.py,sha256=QeTx8dqov1NwNSEam9VC_wq36nRCUpbJpY4hH1NvyNg,32493
+pygeodesy/auxilats/auxily.py,sha256=spSRS9beouT-qH98QhqMk9sm2qKubW8kwNYVWkFu3iU,8234
+pygeodesy/deprecated/__init__.py,sha256=cBYqbh5Njkd5SnaJDaMUP6PL66HfLWii_JoLjnKfnP4,2815
+pygeodesy/deprecated/bases.py,sha256=nxUtxscAg5cb7HEzTSmPJFafLc9Ad2SL5ovwkYaU5z8,1655
+pygeodesy/deprecated/classes.py,sha256=gktUr5qYXCm8ztH6lfzFgaHKqMiw1tHc1Vw6i6DEvNA,12377
+pygeodesy/deprecated/consterns.py,sha256=W-rQiw443_zCFEUzjCGykGND-i5P_ghEIyJUSGg7-Nc,1908
+pygeodesy/deprecated/datum.py,sha256=s8Hke053RucP5ACvg3gdX8weQfGM0x59pQyHpY11eOs,1875
+pygeodesy/deprecated/functions.py,sha256=EZMZe9WGkcbwmLDoWO2xKJyFlUkWAAMxmlbtCLa28lM,13866
+pygeodesy/deprecated/nvector.py,sha256=_dZf84RdmPr7e7i8Yi683R-8Mqn0ipTqIsDhNl29hGo,2117
+pygeodesy/deprecated/rhumbBase.py,sha256=d7YKW--dnRpobB2CSvhFsntWF0B5-HYJqID2pv5lD5k,1375
+pygeodesy/deprecated/rhumbaux.py,sha256=n29xazYMbVG4MJkLjAGu8B88bbcFF5xnvuj9xSxjfIk,1428
+pygeodesy/deprecated/rhumbsolve.py,sha256=QprjRfo5T1_C4ovaa1cffAcmNczzkhGIfmybAup9a9w,1431
+pygeodesy/deprecated/rhumbx.py,sha256=OS0p_meaoVrpZe5UhK6qZljjlrGpL0pCHWw8gofw7ks,1425
+pygeodesy/geodesicx/_C4_24.py,sha256=kS4XMR9m7iBs01V8K0Oz9qTYmjN-icIQGpc_8iwVhig,90750
+pygeodesy/geodesicx/_C4_27.py,sha256=bPbj2Ckrn9WJglm3SNTXyMkULNwANM0tCQ-LKxP1L58,134258
+pygeodesy/geodesicx/_C4_30.py,sha256=QZO8p971ztJwDGLOaJYgIhklztz9GlqbtS-xRP_E7o4,201964
+pygeodesy/geodesicx/__init__.py,sha256=4qAIrE-cnOvi1B38iK-52PB2BpB1zxsVYEryHm4QTJk,2478
+pygeodesy/geodesicx/__main__.py,sha256=JnKrYmg1q9J5wRRqUy-dQ9abj2-2jpWtrolMMaFfWiY,3176
+pygeodesy/geodesicx/gx.py,sha256=0ohLWR_xllBfHyMzcwHTSgKE8FW4IH22IEXo3uAI-eI,60585
+pygeodesy/geodesicx/gxarea.py,sha256=-Kwe6spe2MSQbeLFDd6UN2NOi4JOjYhHAEzonOU3u4A,19409
+pygeodesy/geodesicx/gxbases.py,sha256=Awt9zc1lyPS0vp4df2u4H_rhMeFu1pJaZPhb1iMoc-Q,5693
+pygeodesy/geodesicx/gxline.py,sha256=ZmRIO08IY4s0xJnCRrx2rF3z6XZ9_joUom77P_TsRaA,27514
+pygeodesy/rhumb/__init__.py,sha256=kTuNSKiiQyXvQdYc5KUd5admuKJ2QmDCWQwkIobnM-w,2207
+pygeodesy/rhumb/aux_.py,sha256=lOjpEU3Pe2I5DwC933UCf-SW73l5NMuDACeZhbVs3lE,16657
+pygeodesy/rhumb/bases.py,sha256=awpP60K6EOzS753oXM-h9S6paS6FwoCnco8Zt8n81jY,54162
+pygeodesy/rhumb/ekx.py,sha256=JsmdCatWKqsffF8jCh4HDu5IKt_kHq1qUdmP1LMuofY,24044
+pygeodesy/rhumb/solve.py,sha256=bnmoPZUUw6sPhZ2HDigvPaE-L5M7ddEPf3ZdWvfBX5k,24043
+PyGeodesy-24.7.7.dist-info/METADATA,sha256=22FKDjrVIiF_zPFqvlpXLoJ4QTv58ARwic_X9u639as,19411
+PyGeodesy-24.7.7.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
+PyGeodesy-24.7.7.dist-info/top_level.txt,sha256=cEQPatCXzKZqrivpULC5V5fuy9_V_bAwaP_gUGid7pQ,10
+PyGeodesy-24.7.7.dist-info/RECORD,,

pygeodesy/__init__.py

@@ -101,6 +101,11 @@ and L{GnomonicGeodSolve} depend on I{Karney}'s C++ utility U{GeodSolve
 <https://GeographicLib.SourceForge.io/C++/doc/GeodSolve.1.html>} to be executable and set with
 env variable C{PYGEODESY_GEODSOLVE} or with property L{Ellipsoid.geodsolve}.
 
+Class L{Intersectool} and module L{geodesici} need I{Karney}'s C++ utility U{IntersectTool
+<https://GeographicLib.SourceForge.io/C++/doc/IntersectTool.1.html>} to be executable and set with
+env variable C{PYGEODESY_INTERSECTTOOL}.
+
+
 To compare C{MGRS} results from modules L{mgrs} and C{testMgrs} with I{Karney}'s C++ utility
 U{GeoConvert<https://GeographicLib.SourceForge.io/C++/doc/GeoConvert.1.html>}, the latter must
 be executable and set with env variable C{PYGEODESY_GEOCONVERT}.
@@ -145,7 +150,7 @@ Test coverage has been measured with U{coverage<https://PyPI.org/project/coverag
 
 PyPy 7.3.12 (Python 3.10.12), Python 3.11.5, 3.10.8 and 3.9.6 ran on Apple M1 Silicon (C{arm64}), I{natively}.
 Python 3.8.10 and 2.7.18 ran on Intel (C{x86_64}) or Intel I{emulation} ("C{arm64_x86_64}", see function
-L{pygeodesy.machine}).
+L{machine<pygeodesy.machine>}).
 
 The tests also ran with Python 3.11.5 (and U{geographiclib<https://PyPI.org/project/geographiclib>} 2.0) on
 U{Debian 11<https://Cirrus-CI.com/github/mrJean1/PyGeodesy/master>} in 64-bit only and with Python 3.11.5,
@@ -192,34 +197,35 @@ Env variables
 
 The following environment variables are observed by C{PyGeodesy}:
 
- - C{PYGEODESY_EXCEPTION_CHAINING} - see module L{pygeodesy.errors}.
- - C{PYGEODESY_FMT_FORM} - see module L{pygeodesy.dms}.
- - C{PYGEODESY_FSUM_RESIDUAL} - see module L{pygeodesy.fsums} and class L{pygeodesy.Fsum}.
- - C{PYGEODESY_GEOCONVERT} - see module L{pygeodesy.mgrs}.
- - C{PYGEODESY_GEODSOLVE} - see module L{pygeodesy.geodsolve}.
- - C{PYGEODESY_LAZY_IMPORT} - see module L{pygeodesy.lazily} and variable L{pygeodesy.isLazy}.
- - C{PYGEODESY_NOTIMPLEMENTED} - __special__ methods return C{NotImplemented} if set to "std".
- - C{PYGEODESY_RHUMBSOLVE} - see module L{pygeodesy.rhumb.solve}.
- - C{PYGEODESY_UPS_POLES} - see modules L{pygeodesy.ups} and L{pygeodesy.mgrs}.
+ - C{PYGEODESY_EXCEPTION_CHAINING} - see module L{errors<pygeodesy.errors>}.
+ - C{PYGEODESY_FMT_FORM} - see module L{dms<pygeodesy.dms>}.
+ - C{PYGEODESY_FSUM_RESIDUAL} - see module L{fsums<pygeodesy.fsums>} and class L{Fsum<pygeodesy.Fsum>}.
+ - C{PYGEODESY_GEOCONVERT} - see module L{mgrs<pygeodesy.mgrs>}.
+ - C{PYGEODESY_GEODSOLVE} - see module L{geodsolve<pygeodesy.geodsolve>}.
+ - C{PYGEODESY_INTERSECTTOOL} - see modules L{geodesici<pygeodesy.geodesici>}.
+ - C{PYGEODESY_LAZY_IMPORT} - see module L{lazily<pygeodesy.lazily>} and variable L{isLazy<pygeodesy.isLazy>}.
+ - C{PYGEODESY_NOTIMPLEMENTED} - C{__special__} methods return C{NotImplemented} if set to "std".
+ - C{PYGEODESY_RHUMBSOLVE} - see module L{rhumb.solve<pygeodesy.rhumb.solve>}.
+ - C{PYGEODESY_UPS_POLES} - see modules L{ups<pygeodesy.ups>} and L{mgrs<pygeodesy.mgrs>}.
 
 and these to control standard or I{named} C{repr}esentations:
 
- - C{PYGEODESY_BEARING_STD_REPR} - see method L{pygeodesy.Bearing}C{.__repr__}.
- - C{PYGEODESY_BOOL_STD_REPR} - see method L{pygeodesy.Bool}C{.__repr__}.
- - C{PYGEODESY_DEGREES_STD_REPR} - see method L{pygeodesy.Degrees}C{.__repr__}.
- - C{PYGEODESY_FLOAT_STD_REPR} - see method L{pygeodesy.Float}C{.__repr__}.
- - C{PYGEODESY_INT_STD_REPR} - see method L{pygeodesy.Int}C{.__repr__}.
- - C{PYGEODESY_METER_STD_REPR} - see method L{pygeodesy.Meter}C{.__repr__}.
- - C{PYGEODESY_RADIANS_STD_REPR} - see method L{pygeodesy.Radians}C{.__repr__}.
- - C{PYGEODESY_STR_STD_REPR} - see method L{pygeodesy.Str}C{.__repr__}.
+ - C{PYGEODESY_BEARING_STD_REPR} - see method L{Bearing<pygeodesy.Bearing>}C{.__repr__}.
+ - C{PYGEODESY_BOOL_STD_REPR} - see method L{Bool<pygeodesy.Bool>}C{.__repr__}.
+ - C{PYGEODESY_DEGREES_STD_REPR} - see method L{Degrees<pygeodesy.Degrees>}C{.__repr__}.
+ - C{PYGEODESY_FLOAT_STD_REPR} - see method L{Float<pygeodesy.Float>}C{.__repr__}.
+ - C{PYGEODESY_INT_STD_REPR} - see method L{Int<pygeodesy.Int>}C{.__repr__}.
+ - C{PYGEODESY_METER_STD_REPR} - see method L{Meter<pygeodesy.Meter>}C{.__repr__}.
+ - C{PYGEODESY_RADIANS_STD_REPR} - see method L{Radians<pygeodesy.Radians>}C{.__repr__}.
+ - C{PYGEODESY_STR_STD_REPR} - see method L{Str<pygeodesy.Str>}C{.__repr__}.
 
 plus during development:
 
  - C{PYGEODESY_FOR_DOCS} - for extended documentation by C{epydoc}.
- - C{PYGEODESY_GEOGRAPHICLIB} - see module L{pygeodesy.karney}.
- - C{PYGEODESY_WARNINGS} - see module L{pygeodesy.props} and function L{pygeodesy.DeprecationWarnings}.
- - C{PYGEODESY_XPACKAGES} - see module L{pygeodesy.basics}.
- - C{PYTHONDEVMODE} - see modules L{pygeodesy.errors} and L{pygeodesy.props}.
+ - C{PYGEODESY_GEOGRAPHICLIB} - see module L{karney<pygeodesy.karney>}.
+ - C{PYGEODESY_WARNINGS} - see module L{props<pygeodesy.props>} and function L{DeprecationWarnings<pygeodesy.DeprecationWarnings>}.
+ - C{PYGEODESY_XPACKAGES} - see module L{basics<pygeodesy.basics>}.
+ - C{PYTHONDEVMODE} - see modules L{errors<pygeodesy.errors>} and L{props<pygeodesy.props>}.
 
 and:
 
@@ -233,8 +239,7 @@ and:
 License
 =======
 
-**) U{Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.
-<https://OpenSource.org/licenses/MIT>}
+**) U{Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.<https://OpenSource.org/licenses/MIT>}
 
 C{Permission is hereby granted, free of charge, to any person obtaining a copy of this software
 and associated documentation files (the "Software"), to deal in the Software without restriction,
@@ -298,14 +303,14 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.}
 @var F_RAD__: Convert degrees to radians and format as signed "-/+RR" I{without} symbol, I{without} suffix (C{str}).
 
 @var DIG:      System's M{float decimal digits} = 15 (C{int}).
-@var INF:      Infinity (C{float}), see functions L{pygeodesy.isinf} and L{pygeodesy.isfinite} and C{NINF}.
-@var INT0:     C{int(0)}, missing Z-components, C{if B{z}=B{INT0}}, see functions L{pygeodesy.isint0}, L{pygeodesy.meeus2}
+@var INF:      Infinity (C{float}), see functions L{isinf<pygeodesy.isinf>} and L{isfinite<pygeodesy.isfinite>} and C{NINF}.
+@var INT0:     C{int(0)}, missing Z-components, C{if B{z}=B{INT0}}, see functions L{isint0<pygeodesy.isint0>}, L{meeus2<pygeodesy.meeus2>}
 @var MANT_DIG: System's M{float mantissa bits} = 53 (C{int}).
 @var MAX:      System's M{float max} ≈ 1.798e+308 (C{float}).
 @var MIN:      System's M{float min} ≈ 2.225e-308 (C{float}).
-@var NAN:      Not-A-Number (C{float}), see function L{pygeodesy.isnan}.
-@var NEG0:     Negative 0.0 (C{float}), see function L{pygeodesy.isneg0}.
-@var NINF:     Negative infinity (C{float}), see function L{pygeodesy.isninf} and C{INF}.
+@var NAN:      Not-A-Number (C{float}), see function L{isnan<pygeodesy.isnan>}.
+@var NEG0:     Negative 0.0 (C{float}), see function L{isneg0<pygeodesy.isneg0>}.
+@var NINF:     Negative infinity (C{float}), see function L{isninf<pygeodesy.isninf>} and C{INF}.
 @var NN:       Empty (C{str}), U{I{Nomen Nescio}<https://Wiktionary.org/wiki/N.N.>}.
 
 @var PI:    Constant M{math.pi} (C{float}).
@@ -331,9 +336,9 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.}
 @var S_DEG: Degrees symbol, default C{"°"}
 @var S_MIN: Minutes symbol, default C{"′"} aka I{PRIME}
 @var S_SEC: Seconds symbol, default C{"″"} aka I{DOUBLE_PRIME}
-@var S_RAD: Radians symbol, default C{""} aka L{pygeodesy.NN}
+@var S_RAD: Radians symbol, default C{""} aka L{NN<pygeodesy.NN>}
 @var S_DMS: If C{True} include, otherwise cancel all DMS symbols, default C{True}.
-@var S_SEP: Separator between C{deg°|min′|sec″|suffix}, default C{""} aka L{pygeodesy.NN}
+@var S_SEP: Separator between C{deg°|min′|sec″|suffix}, default C{""} aka L{NN<pygeodesy.NN>}
 
 @var Conics:     Registered, predefined conics (C{enum-like}).
 @var Datums:     Registered, predefined datums (C{enum-like}).
@@ -413,6 +418,7 @@ if _init__all__ and not _lazy_import2:  # import and set __all__
     import pygeodesy.fstats                as fstats                 # PYCHOK exported
     import pygeodesy.fsums                 as fsums                  # PYCHOK exported
     import pygeodesy.gars                  as gars                   # PYCHOK exported
+    import pygeodesy.geodesici             as geodesici              # PYCHOK exported
     import pygeodesy.geodesicw             as geodesicw              # PYCHOK exported
     import pygeodesy.geodesicx             as geodesicx              # PYCHOK exported
     import pygeodesy.geodsolve             as geodsolve              # PYCHOK exported
@@ -497,6 +503,7 @@ if _init__all__ and not _lazy_import2:  # import and set __all__
     from pygeodesy.fstats                import *  # PYCHOK __all__
     from pygeodesy.fsums                 import *  # PYCHOK __all__
     from pygeodesy.gars                  import Garef, GARSError  # PYCHOK lazily
+    from pygeodesy.geodesici             import *  # PYCHOK __all__
     from pygeodesy.geodesicw             import *  # PYCHOK __all__
     from pygeodesy.geodesicx             import *  # PYCHOK __all__
     from pygeodesy.geodsolve             import *  # PYCHOK __all__
@@ -589,7 +596,7 @@ else:
 
 from pygeodesy.internals import _version2,  _DOT_  # PYCHOK import
 # from pygeodesy.interns import _DOT_  # from .internals
-__version__ = '24.06.09'
+__version__ = '24.07.07'
 # see setup.py for similar logic
 version     = _DOT_(*_version2(__version__, n=3))
 

pygeodesy/__main__.py

@@ -5,7 +5,7 @@ u'''Print L{pygeodesy} version, etc. using C{python -m pygeodesy}.
 '''
 
 __all__ = ()
-__version__ = '24.05.15'
+__version__ = '24.07.07'
 
 from os.path import basename, dirname
 
@@ -42,6 +42,11 @@ def _main():  # PYCHOK no cover
                 v.append(_name_version(pkg))
 
         v = _Pythonarchine()
+        try:
+            import coverage as pkg
+            v.append(_name_version(pkg))
+        except ImportError:
+            pass
         _nv(_xgeographiclib, v)
         _nv(_xnumpy, v)
         _nv(_xscipy, v)

pygeodesy/albers.py

@@ -38,7 +38,7 @@ from pygeodesy.utily import atan1, atan1d, degrees360, sincos2, sincos2d, \
 from math import atan2, atanh, degrees, fabs, radians, sqrt
 
 __all__ = _ALL_LAZY.albers
-__version__ = '24.05.21'
+__version__ = '24.06.11'
 
 _k1_    = 'k1'
 _NUMIT  =   8  # XXX 4?
@@ -354,7 +354,7 @@ class _AlbersBase(_NamedBase):
                               and optional, additional B{C{LatLon}} keyword
                               arguments, ignored if C{B{LatLon} is None}.
 
-           @return: The geodetic (C{LatLon}) or if B{C{LatLon}} is C{None} an
+           @return: The geodetic (C{LatLon}) or if C{B{LatLon} is None} an
                     L{Albers7Tuple}C{(x, y, lat, lon, gamma, scale, datum)}.
 
            @note: The origin latitude is returned by C{property lat0}.  No

pygeodesy/auxilats/__init__.py

@@ -29,7 +29,7 @@ from pygeodesy.lazily import _ALL_OTHER
 # no modules: auxAngle, auxDLat, auxDST, auxily, auxLat
 __all__ = _ALL_OTHER(Aux, AuxAngle, AuxDLat, AuxDST, AuxLat,
                      AuxBeta, AuxChi, AuxMu, AuxPhi, AuxTheta, AuxXi)
-__version__ = '24.05.31'
+__version__ = '24.06.16'
 
 # **) MIT License
 #

pygeodesy/auxilats/auxAngle.py

@@ -14,14 +14,14 @@ under the MIT/X11 License.  For more information, see the U{GeographicLib
 # make sure int/int division yields float quotient, see .basics
 from __future__ import division as _; del _  # PYCHOK semicolon
 
-from pygeodesy.auxilats.auxily import Aux, _Aux2Greek
-from pygeodesy.basics import _xinstanceof
+from pygeodesy.auxilats.auxily import Aux, _Aux2Greek,  AuxError
+from pygeodesy.basics import map1, map2, _xinstanceof
 from pygeodesy.constants import EPS, _INF_NAN_NINF, MAX, NAN, _0_0, _0_5, _1_0, \
                                _copysign_1_0, _over, _pos_self, isfinite, isnan
-from pygeodesy.errors import AuxError, _UnexpectedError, _xkwds_pop2
+# from pygeodesy.errors import AuxError  # from .auxilats.auxily
 from pygeodesy.fmath import hypot,  unstr
 from pygeodesy.fsums import _add_op_, _iadd_op_, _isub_op_, _sub_op_
-from pygeodesy.named import _name2__, _Named,  _ALL_DOCS, _MODS
+from pygeodesy.named import _Named,  _ALL_DOCS, _MODS
 # from pygeodesy.lazily import _ALL_DOCS, _ALL_MODS as _MODS  # from .named
 from pygeodesy.props import Property, Property_RO, property_RO, _update_all
 # from pygeodesy.streprs import unstr  # from .fmath
@@ -31,7 +31,7 @@ from pygeodesy.utily import atan2d, sincos2, sincos2d
 from math import asinh, atan2, copysign, degrees, fabs, radians, sinh
 
 __all__ = ()
-__version__ = '24.05.25'
+__version__ = '24.06.16'
 
 _0_INF_NAN_NINF = (0, _0_0) + _INF_NAN_NINF
 _MAX_2          =  MAX * _0_5  # PYCHOK used!
@@ -44,38 +44,37 @@ class AuxAngle(_Named):
     '''
     _AUX  =  None  # overloaded/-ridden
     _diff =  NAN   # default
-    _iter =  None  # like .Named._NamedBase
+    _iter =  None  # like ._NamedBase
     _y    = _0_0
     _x    = _1_0
 
-    def __init__(self, y_angle=_0_0, x=_1_0, **name_aux):
+    def __init__(self, y_angle=_0_0, x=_1_0, aux=None, **name):
         '''New L{AuxAngle}.
 
            @kwarg y_angle: The Y component (C{scalar}, including C{INF}, C{NAN}
                            and C{NINF}) or a previous L{AuxAngle} instance.
-           @kwarg x: The X component, ignored if C{B{y_angle}} is non-C{scalar}.
-           @kwarg name_aux: Optional C{B{name}=NN} (C{str}) and I{Auxiliary} kind
-                      (C{B{aux}=Aux.KIND}), ignored if B{C{y_angle}} is L{AuxAngle}.
+           @kwarg x: The X component, required if C{B{y_angle}} is C{scalar},
+                     ignored otherwise.
+           @kwarg aux: I{Auxiliary} kind (C{Aux.KIND}), like B{C{x}}.
+           @kwarg name: Optional C{B{name}=NN} see (C{str}).
 
            @raise AuxError: Invalid B{C{y_angle}}, B{C{x}} or B{C{aux}}.
         '''
-        name, aux = _name2__(**name_aux)
         try:
-            yx = y_angle._yx
-            if self._AUX is None:
-                self._AUX  = y_angle._AUX
-            if self._diff != y_angle._diff:
-                self._diff = y_angle._diff
-        except AttributeError:
-            yx = y_angle, x
-            if aux:
-                a, kwds = _xkwds_pop2(aux, aux=self._AUX)
-                if kwds:
-                    raise _UnexpectedError(**kwds)
-                if a is not self._AUX:
-                    if a not in _AUXClass:
-                        raise AuxError(aux=a)
-                    self._AUX = a
+            try:
+                yx  = y_angle._yx
+                aux = y_angle._AUX
+                if self._diff != y_angle._diff:
+                    self._diff = y_angle._diff
+            except AttributeError:
+                yx  = y_angle, x
+            if aux in _AUXClass:
+                if self._AUX != aux:
+                    self._AUX = aux
+            elif aux is not None:
+                raise ValueError()  # _invalid_
+        except Exception as X:
+            raise AuxError(y=y_angle, x=x, aux=aux, cause=X)
         self._y, self._x = _yx2(yx)
         if name:
             self.name = name
@@ -84,7 +83,7 @@ class AuxAngle(_Named):
         '''Return this angle's absolute value (L{AuxAngle}).
         '''
         a     = self._copy_2(self.__abs__)
-        a._yx = map(fabs, self._yx)
+        a._yx = map2(fabs, self._yx)
         return a
 
     def __add__(self, other):
@@ -230,28 +229,28 @@ class AuxAngle(_Named):
         return self._diff
 
     @staticmethod
-    def fromDegrees(deg, **name_aux):
+    def fromDegrees(deg, **aux_name):
         '''Get an L{AuxAngle} from degrees.
         '''
-        return _AuxClass(**name_aux)(*sincos2d(deg), **name_aux)
+        return _AuxClass(**aux_name)(*sincos2d(deg), **aux_name)
 
     @staticmethod
-    def fromLambertianDegrees(psi, **name_aux):
+    def fromLambertianDegrees(psi, **aux_name):
         '''Get an L{AuxAngle} from I{Lambertian} degrees.
         '''
-        return _AuxClass(**name_aux)(sinh(radians(psi)), **name_aux)
+        return _AuxClass(**aux_name)(sinh(radians(psi)), **aux_name)
 
     @staticmethod
-    def fromLambertianRadians(psi, **name_aux):
+    def fromLambertianRadians(psi, **aux_name):
         '''Get an L{AuxAngle} from I{Lambertian} radians.
         '''
-        return _AuxClass(**name_aux)(sinh(psi), **name_aux)
+        return _AuxClass(**aux_name)(sinh(psi), **aux_name)
 
     @staticmethod
-    def fromRadians(rad, **name_aux):
+    def fromRadians(rad, **aux_name):
         '''Get an L{AuxAngle} from radians.
         '''
-        return _AuxClass(**name_aux)(*sincos2(rad), **name_aux)
+        return _AuxClass(**aux_name)(*sincos2(rad), **aux_name)
 
     @Property_RO
     def iteration(self):
@@ -514,13 +513,15 @@ def _AuxClass(aux=None, **unused):  # PYCHOK C{classof(aux)}
 
 
 def _yx2(yx):
+    '''(INTERNAL) Validate 2-tuple C{(y, x)}.
+    '''
     try:
-        y, x = map(float, yx)
+        y, x = yx
+        y, x = map1(float, y, x)
         if y in _0_INF_NAN_NINF:
             x = _copysign_1_0(x)
-    except (TypeError, ValueError) as e:
-        y, x = yx
-        raise AuxError(y=y, x=x, cause=e)
+    except (TypeError, ValueError) as X:
+        raise AuxError(y=y, x=x, cause=X)
     return y, x
 
 

pygeodesy/auxilats/auxDLat.py

@@ -26,7 +26,7 @@ from pygeodesy.elliptic import Elliptic as _Ef,  Fsum
 from math import atan2, cos, sin, sqrt
 
 __all__ = ()
-__version__ = '23.12.01'
+__version__ = '24.06.16'
 
 
 class AuxDLat(AuxLat):
@@ -138,7 +138,8 @@ class AuxDLat(AuxLat):
         txy = tx * ty
         if txy < 0 or (isinf(ty) and not tx):
             _a =  atan1
-            r  = _over(_a(fm1 * ty) - _a(fm1 * tx), _a(ty) - _a(tx))
+            r  = _a(fm1 * ty) - _a(fm1 * tx)
+            r  = _over(r, _a(ty) - _a(tx))
         elif tx == ty:  # includes tx = ty = inf
             if txy > 1:  # == tx**2
                 txy = _1_over(txy)

pygeodesy/auxilats/auxLat.py

@@ -22,8 +22,9 @@ from pygeodesy.basics import _reverange, _xinstanceof,  _passarg
 from pygeodesy.constants import INF, MAX_EXP, MIN_EXP, NAN, PI_2, PI_4, _EPSqrt, \
                                _0_0, _0_0s, _0_1, _0_25, _0_5, _1_0, _2_0, _3_0, \
                                _360_0, isfinite, isinf, isnan, _log2, _over
-from pygeodesy.datums import _ellipsoidal_datum, _WGS84,  Ellipsoid, _name__
-# from pygeodesy.ellipsoids import Ellipsoid  # from .datums
+from pygeodesy.datums import _ellipsoidal_datum, _WGS84, \
+                              Ellipsoid, _name__, _EWGS84
+# from pygeodesy.ellipsoids import Ellipsoid, _EWGS84  # from .datums
 from pygeodesy.elliptic import Elliptic as _Ef
 from pygeodesy.errors import AuxError, _xkwds_not, _xkwds_pop2, _Xorder
 # from pygeodesy.fmath import cbrt  # from .karney
@@ -46,7 +47,7 @@ except ImportError:  # Python 3.11-
         return pow(_2_0, x)
 
 __all__ = ()
-__version__ = '24.05.24'
+__version__ = '24.06.16'
 
 _TRIPS = 1024  # XXX 2 or 3?
 
@@ -64,24 +65,21 @@ class AuxLat(AuxAngle):
              <https://GeographicLib.SourceForge.io/C++/doc/classGeographicLib_1_1AuxLatitude.html>}.
     '''
     _csc  =  dict()  # global coeffs cache: [aL][k], upto max(k) * (4 + 6 + 8) floats
-    _E    = _WGS84.ellipsoid
+    _E    = _EWGS84
 #   _Lmax =  0       # overwritten below
     _mAL  =  6       # 4, 6 or 8 aka Lmax
 
-    def __init__(self, a_earth=_WGS84, f=None, b=None, **ALorder_name):
+    def __init__(self, a_earth=_EWGS84, f=None, b=None, **ALorder_name):
         '''New L{AuxLat} instance on an ellipsoid or datum.
 
-           @arg a_earth: Equatorial radius, semi-axis (C{meter}) or an
-                         ellipsoid or datum (L{Datum}, L{Ellipsoid},
-                         L{Ellipsoid2} or L{a_f2Tuple}).
-           @kwarg f: Flattening: M{(a - b) / a} (C{float}, near zero for
-                     spherical), ignored if B{C{a_earth}} is not scalar.
-           @kwarg b: Optional polar radius, semi-axis (C{meter}, same
-                     units as B{C{a_earth}}), ignored if B{C{a_earth}}
-                     is not scalar.
-           @kwarg ALorder_name: Optional C{B{name}=NN} (C{str}) and optional
-                          keyword argument C{B{ALorder}=6} for the order of
-                          this L{AuxLat}, see property C{ALorder}.
+           @arg a_earth: Equatorial radius, semi-axis (C{meter}) or an ellipsoid or
+                         datum (L{Datum}, L{Ellipsoid}, L{Ellipsoid2} or L{a_f2Tuple}).
+           @kwarg f: Flattening: M{(a - b) / a} (C{float}, near zero for spherical),
+                     required if B{C{a_earth}} is C{scalar} and C{B{b}=None}.
+           @kwarg b: Optional polar radius, semi-axis (C{meter}, required if B{C{a_earth}}
+                     is C{scalar} and C{B{f}=None}.
+           @kwarg ALorder_name: Optional C{B{name}=NN} (C{str}) and optional order of
+                          this L{AuxLat} C{B{ALorder}=6}, see property C{ALorder}.
         '''
         if ALorder_name:
             M = self._mAL
@@ -91,7 +89,7 @@ class AuxLat(AuxAngle):
         else:
             name = NN
         try:
-            if a_earth is not _WGS84:
+            if a_earth not in (_EWGS84, _WGS84):
                 n = _name__(name, name__=AuxLat)
                 if b is f is None:
                     E = _ellipsoidal_datum(a_earth, name=n).ellipsoid  # XXX raiser=_earth_
@@ -101,7 +99,7 @@ class AuxLat(AuxAngle):
                     raise ValueError(_not_scalar_)
                 self._E = E
             elif not (b is f is None):
-                # _UnexpectedError into AuxError
+                # turn _UnexpectedError into AuxError
                 name = _name__(name, **_xkwds_not(None, b=b, f=f))
 
             if name:

pygeodesy/auxilats/auxily.py

@@ -212,7 +212,7 @@ def _h(tx):
 
 
 def _sn(tx):
-    '''(INTERNAL) M{tx / sqrt(tx**2 + 1)}, converting tan to sin.
+    '''(INTERNAL) M{sin(x) = tan(x) / sqrt(tan(x)**2 + 1)}.
     '''
     if tx:
         tx = _copysign_1_0(tx) if isinf(tx) else (