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

pygeodesy/ellipsoidalBase.py

@@ -35,7 +35,7 @@ from pygeodesy.units import Epoch, _isDegrees, Radius_, _1mm as _TOL_M
 # from math import fabs  # from .latlonBase
 
 __all__ = _ALL_LAZY.ellipsoidalBase
-__version__ = '24.06.24'
+__version__ = '24.08.14'
 
 
 class CartesianEllipsoidalBase(CartesianBase):
@@ -111,7 +111,7 @@ class CartesianEllipsoidalBase(CartesianBase):
                          C{Vector3Tuple} or C{Vector4Tuple}).
            @arg radius2: Radius of the second sphere or circle (same units as this and
                          the B{C{other}} point's coordinates).
-           @kwarg sphere: If C{True} compute the center and radius of the intersection
+           @kwarg sphere: If C{True}, compute the center and radius of the intersection
                           of two I{spheres}.  If C{False}, ignore the C{z}-component and
                           compute the intersection of two I{circles} (C{bool}).
            @kwarg Vector: Class to return intersections (C{Cartesian}, L{Vector3d} or
@@ -527,7 +527,7 @@ class LatLonEllipsoidalBase(LatLonBase):
                   point is computed as the C{destination} along that bearing at
                   about 1.5 times the distance from the start point to an initial
                   gu-/estimate of the intersection point (and between 1/8 and 3/8
-                  of the authalic earth perimeter).
+                  of the C{authalic} earth perimeter).
 
            @see: I{Karney's} U{intersect.cpp<https://SourceForge.net/p/geographiclib/
                  discussion/1026621/thread/21aaff9f/>}, U{The B{ellipsoidal} case<https://
@@ -659,7 +659,7 @@ class LatLonEllipsoidalBase(LatLonBase):
 
            @arg point1: Start point (C{LatLon}).
            @arg point2: End point (C{LatLon}).
-           @kwarg within: If C{True} return the closest point I{between}
+           @kwarg within: If C{True}, return the closest point I{between}
                           B{C{point1}} and B{C{point2}}, otherwise the
                           closest point elsewhere on the geodesic (C{bool}).
            @kwarg height: Optional height for the closest point (C{meter},
@@ -714,8 +714,8 @@ class LatLonEllipsoidalBase(LatLonBase):
                          I{without conversion}.
            @kwarg epoch: Optional datum (L{Epoch}), overriding this epoch
                          I{without conversion}.
-           @kwarg reframe: Optional datum (L{RefFrame}), overriding this
-                           reframe I{without conversion}.
+           @kwarg reframe: Optional reference frame (L{RefFrame}), overriding
+                           this reframe I{without conversion}.
            @kwarg sep: Optional separator (C{str}).
            @kwarg wrap: If C{True}, wrap or I{normalize} the lat- and
                         longitude (C{bool}).
@@ -726,7 +726,8 @@ class LatLonEllipsoidalBase(LatLonBase):
            @raise ParseError: Invalid B{C{strllh}}.
         '''
         a, b, h = _MODS.dms.parse3llh(strllh, height=height, sep=sep, wrap=wrap)
-        r = self.classof(a, b, height=h, datum=self.datum)
+        r = self.classof(a, b, height=h, datum=self.datum, epoch=self.epoch,
+                                                         reframe=self.reframe)
         if datum not in (None, self.datum):
             r.datum = datum
         if epoch not in (None, self.epoch):
@@ -865,7 +866,7 @@ class LatLonEllipsoidalBase(LatLonBase):
     def toOsgr(self, kTM=False, **toOsgr_kwds):
         '''Convert this C{LatLon} point to an OSGR coordinate.
 
-           @kwarg kTM: If C{True} use I{Karney}'s Krüger method from module
+           @kwarg kTM: If C{True}, use I{Karney}'s Krüger method from module
                        L{ktm}, otherwise I{Ordinance Survery}'s recommended
                        formulation (C{bool}).
            @kwarg toOsgr_kwds: Optional L{pygeodesy.toOsgr} keyword arguments.
@@ -1008,13 +1009,15 @@ class LatLonEllipsoidalBase(LatLonBase):
 
            @arg bearing1: Bearing at this point (compass C{degrees360}).
            @arg other: Start point of the other line (C{LatLon}).
-           @arg bearing2: Bearing at the other point (compass C{degrees360}).
+           @arg bearing2: Bearing at the B{C{other}} point (compass C{degrees360}).
            @kwarg height_wrap_tol: Optional keyword arguments C{B{height}=None},
-                         C{B{wrap}=False} and C{B{tol}}, see method L{intersection3}.
+                         C{B{wrap}=False} and C{B{tol}}, see method L{intersection3
+                         <pygeodesy.ellipsoidalBase.LatLonEllipsoidalBase>}.
 
            @return: Triangulated point (C{LatLon}).
 
-           @see: Method L{intersection3} for further details.
+           @see: Method L{intersection3<pygeodesy.ellipsoidalBase.LatLonEllipsoidalBase>}
+                 for further details.
         '''
         if _isDegrees(bearing1) and _isDegrees(bearing2):
             r = self.intersection3(bearing1, other, bearing2, **height_wrap_tol)
@@ -1034,13 +1037,13 @@ class LatLonEllipsoidalBase(LatLonBase):
            @arg point3: Third center point (C{LatLon}).
            @arg distance3: Distance to point3 (C{meter}, same units as
                            B{C{eps}}).
-           @kwarg area: If C{True} compute the area overlap, otherwise the
+           @kwarg area: If C{True}, compute the area overlap, otherwise the
                         perimeter intersection of the circles (C{bool}).
            @kwarg eps: The required I{minimal overlap} for C{B{area}=True}
                        or the I{intersection margin} for C{B{area}=False}
                        (C{meter}, conventionally).
-           @kwarg wrap: If C{True}, wrap or I{normalize} and unroll
-                        B{C{point2}} and B{C{point3}} (C{bool}).
+           @kwarg wrap: If C{True}, wrap or I{normalize} and unroll B{C{point2}}
+                        and B{C{point3}} (C{bool}).
 
            @return: A L{Trilaterate5Tuple}C{(min, minPoint, max, maxPoint, n)}
                     with C{min} and C{max} in C{meter}, same units as B{C{eps}},
@@ -1049,7 +1052,7 @@ class LatLonEllipsoidalBase(LatLonBase):
                     of trilatered points found for the given B{C{eps}}.
 
                     If only a single trilaterated point is found, C{min I{is}
-                    max}, C{minPoint I{is} maxPoint} and C{n = 1}.
+                    max}, C{minPoint I{is} maxPoint} and C{n=1}.
 
                     For C{B{area}=True}, C{min} and C{max} are the smallest
                     respectively largest I{radial} overlap found.

pygeodesy/ellipsoidalExact.py

@@ -24,7 +24,7 @@ from pygeodesy.points import _areaError, ispolar  # PYCHOK exported
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.ellipsoidalExact
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 
 class Cartesian(CartesianEllipsoidalBase):
@@ -252,7 +252,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalGeodSolve.py

@@ -24,7 +24,7 @@ from pygeodesy.points import _areaError, ispolar  # PYCHOK exported
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.ellipsoidalGeodSolve
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 
 class Cartesian(CartesianEllipsoidalBase):
@@ -244,7 +244,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalKarney.py

@@ -42,7 +42,7 @@ from pygeodesy.props import deprecated_method, Property_RO
 # from math import fabs  # from .karney
 
 __all__ = _ALL_LAZY.ellipsoidalKarney
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 
 class Cartesian(CartesianEllipsoidalBase):
@@ -279,7 +279,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalNvector.py

@@ -48,7 +48,7 @@ from pygeodesy.units import Bearing, Distance, Height, Scalar
 # from math import fabs  # from .nvectorBase
 
 __all__ = _ALL_LAZY.ellipsoidalNvector
-__version__ = '24.06.15'
+__version__ = '24.08.13'
 
 
 class Ned(_Ned):
@@ -555,7 +555,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},

pygeodesy/ellipsoidalVincenty.py

@@ -59,7 +59,7 @@ from pygeodesy.errors import _and, _ValueError, _xkwds
 from pygeodesy.fmath import Fpolynomial, hypot, hypot1
 from pygeodesy.interns import _ambiguous_, _antipodal_, _COLONSPACE_, \
                               _to_, _SPACE_,  _limit_  # PYCHOK used!
-from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS, _ALL_OTHER
+from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS
 from pygeodesy.namedTuples import Destination2Tuple, Destination3Tuple, \
                                   Distance3Tuple
 from pygeodesy.points import Fmt, ispolar  # PYCHOK exported
@@ -72,7 +72,7 @@ from pygeodesy.utily import atan2b, atan2d, sincos2, sincos2d, unroll180, wrap18
 from math import atan2, cos, degrees, fabs, radians, tan
 
 __all__ = _ALL_LAZY.ellipsoidalVincenty
-__version__ = '24.06.11'
+__version__ = '24.08.13'
 
 _antipodal_to_ = _SPACE_(_antipodal_, _to_)
 
@@ -510,7 +510,7 @@ def nearestOn(point, point1, point2, within=True, height=None, wrap=False,
        @arg point: Reference point (C{LatLon}).
        @arg point1: Start point of the geodesic (C{LatLon}).
        @arg point2: End point of the geodesic (C{LatLon}).
-       @kwarg within: If C{True} return the closest point I{between}
+       @kwarg within: If C{True}, return the closest point I{between}
                       B{C{point1}} and B{C{point2}}, otherwise the
                       closest point elsewhere on the geodesic (C{bool}).
        @kwarg height: Optional height for the closest point (C{meter},
@@ -560,9 +560,10 @@ def perimeterOf(points, **closed_datum_wrap):
         return _MODS.ellipsoidalExact.perimeterOf(points, **closed_datum_wrap)
 
 
-__all__ += _ALL_OTHER(Cartesian, LatLon, intersecant2,  # from .ellipsoidalBaseDI
-                      intersection3, intersections2, ispolar,  # from .points
-                      nearestOn) + _ALL_DOCS(areaOf, perimeterOf)  # deprecated
+__all__ += _ALL_DOCS(Cartesian, LatLon, intersecant2,  # from .ellipsoidalBaseDI
+                     intersection3, intersections2, ispolar,  # from .points
+                     nearestOn,
+                     areaOf, perimeterOf)  # DEPRECATED
 
 # **) MIT License
 #

pygeodesy/epsg.py

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

pygeodesy/fmath.py

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

pygeodesy/fsums.py

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

pygeodesy/gars.py

@@ -18,8 +18,9 @@ Transcoded from I{Charles Karney}'s C++ class U{GARS
 from pygeodesy.constants import _off90, _1_over, _0_5, \
                                 _1_0  # PYCHOK used!
 from pygeodesy.errors import _ValueError, _xkwds, _xStrError
-from pygeodesy.interns import NN, _0to9_, _AtoZnoIO_, _COMMA_, _SPACE_
-from pygeodesy.lazily import _ALL_LAZY, _ALL_OTHER
+from pygeodesy.interns import NN, _0to9_, _AtoZnoIO_, _COMMA_, \
+                             _INV_, _SPACE_
+from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY
 from pygeodesy.named import _name__,  Fmt, isstr, Property_RO
 from pygeodesy.namedTuples import LatLon2Tuple, LatLonPrec3Tuple
 # from pygeodesy.props import Property_RO  # from .named
@@ -29,7 +30,7 @@ from pygeodesy.units import Int_, Lat, Lon, Precision_, Scalar_, Str
 from math import floor
 
 __all__ = _ALL_LAZY.gars
-__version__ = '24.08.02'
+__version__ = '24.08.13'
 
 _Digits  = _0to9_
 _LatLen  =    2
@@ -86,7 +87,7 @@ def _2garstr2(garef):
     try:
         n, garstr = len(garef), garef.upper()
         if n < _MinLen or n > _MaxLen \
-                       or garstr[:3] == 'INV' \
+                       or garstr.startswith(_INV_) \
                        or not garstr.isalnum():
             raise ValueError()
         return garstr, _2Precision(n - _MinLen)
@@ -200,8 +201,8 @@ def decode3(garef, center=True, **name):
     '''Decode a C{garef} to lat-, longitude and precision.
 
        @arg garef: To be decoded (L{Garef} or C{str}).
-       @kwarg center: If C{True} the center, otherwise the south-west,
-                      lower-left corner (C{bool}).
+       @kwarg center: If C{True}, use the garef's center, otherwise
+                      the south-west, lower-left corner (C{bool}).
 
        @return: A L{LatLonPrec3Tuple}C{(lat, lon, precision)}.
 
@@ -339,8 +340,8 @@ def resolution(prec):
     return _Resolutions[max(0, min(p, _MaxPrec))]
 
 
-__all__ += _ALL_OTHER(decode3,  # functions
-                      encode, precision, resolution)
+__all__ += _ALL_DOCS(decode3,  # functions
+                     encode, precision, resolution)
 
 # **) 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.07.11'
+__version__ = '24.08.13'
 
 _MAXIT1 = 20
 _MAXIT2 = 10 + _MAXIT1 + MANT_DIG  # MANT_DIG == C++ digits
@@ -218,8 +218,8 @@ class GeodesicExact(_GeodesicBase):
         '''Set up a L{GeodesicAreaExact} to compute area and
            perimeter of a polygon.
 
-           @kwarg polyline: If C{True} perimeter only, otherwise
-                            area and perimeter (C{bool}).
+           @kwarg polyline: If C{True}, compute the perimeter only, otherwise
+                            the perimeter and area (C{bool}).
            @kwarg name: Optional C{B{name}=NN} (C{str}).
 
            @return: A L{GeodesicAreaExact} instance.

pygeodesy/geodesicx/gxarea.py

@@ -30,7 +30,7 @@ from pygeodesy.props import Property, Property_RO, property_RO
 from math import fmod as _fmod
 
 __all__ = ()
-__version__ = '24.05.19'
+__version__ = '24.08.13'
 
 
 class GeodesicAreaExact(_NamedBase):
@@ -413,8 +413,8 @@ class PolygonArea(GeodesicAreaExact):
 
            @arg earth: A geodesic (L{GeodesicExact}, I{wrapped}
                        C{Geodesic} or L{GeodesicSolve}).
-           @kwarg polyline: If C{True} perimeter only, otherwise
-                            area and perimeter (C{bool}).
+           @kwarg polyline: If C{True}, compute the perimeter only, otherwise
+                            perimeter and area (C{bool}).
            @kwarg name: Optional C{B{name}=NN} (C{str}).
 
            @raise GeodesicError: Invalid B{C{earth}}.

pygeodesy/geodsolve.py

@@ -24,7 +24,7 @@ from pygeodesy.solveBase import _SolveGDictBase, _SolveGDictLineBase
 from pygeodesy.utily import _unrollon, _Wrap, wrap360
 
 __all__ = _ALL_LAZY.geodsolve
-__version__ = '24.07.11'
+__version__ = '24.08.13'
 
 
 class _GeodesicSolveBase(_SolveGDictBase):
@@ -101,8 +101,8 @@ class GeodesicSolve(_GeodesicSolveBase):
         '''Set up a L{GeodesicAreaExact} to compute area and perimeter
            of a polygon.
 
-           @kwarg polyline: If C{True} perimeter only, otherwise area
-                            and perimeter (C{bool}).
+           @kwarg polyline: If C{True}, compute the perimeter only, otherwise
+                            perimeter and area (C{bool}).
            @kwarg name: Optional C{B{name}=NN} (C{str}).
 
            @return: A L{GeodesicAreaExact} instance.

pygeodesy/geohash.py

@@ -24,7 +24,7 @@ from pygeodesy.errors import _ValueError, _xkwds, _xStrError
 # from pygeodesy import formy as _formy  # _MODS
 from pygeodesy.interns import NN, _COMMA_, _DOT_, _E_, _height_, _N_, _NE_, \
                              _NW_, _radius_, _S_, _SE_, _SPACE_, _SW_, _W_, \
-                             _width_
+                             _width_  # _INV_
 from pygeodesy.lazily import _ALL_DOCS, _ALL_LAZY, _ALL_MODS as _MODS
 from pygeodesy.named import _name__, _NamedDict, _NamedTuple, nameof, _xnamed
 from pygeodesy.namedTuples import Bounds2Tuple, Bounds4Tuple, LatLon2Tuple, \
@@ -38,7 +38,7 @@ from pygeodesy.units import Degrees_, Int, Lat_, Lon_, Meter, Precision_, Str
 from math import fabs, ldexp, log10, radians
 
 __all__ = _ALL_LAZY.geohash
-__version__ = '24.08.02'
+__version__ = '24.08.05'
 
 _formy   = _MODS.into(formy=__name__)
 _MASK5   =  16, 8, 4, 2, 1  # PYCHOK used!
@@ -118,8 +118,8 @@ def _2res(res, **prec):
     '''(INTERNAL) Get the C{res}olution for a C{prec}ision.
     '''
     p = max(min(Int(Error=GeohashError, **prec), _MaxPrec), 0) * 5
-    p = (p - p // 2) if res > _180_0 else (p // 2)
-    return ldexp(res, -p) if p else res
+    x = (p - p // 2) if res > _180_0 else (p // 2)
+    return ldexp(res, -x) if x else res  # ldexp == res / float(1 << x)
 
 
 class _GH(object):
@@ -231,7 +231,7 @@ class _GH(object):
         '''Decode C{geohash} into 4-tuple C{(s, w, n, e)}.
         '''
         nc = len(geohash) if isstr(geohash) else 0
-        if not (0 < nc <= _MaxPrec):
+        if not (0 < nc <= _MaxPrec):  # or geohash.startswith(_INV_)
             raise GeohashError(geohash=geohash, len=nc)
         s, w, n, e = self.SWNE4
         D, d, _mid = self.DecodeB32, True, _2mid
@@ -507,6 +507,13 @@ class Geohash(Str):
         '''
         return len(self)
 
+    @Property_RO
+    def resolution2(self):
+        '''Get the I{lon-} and I{latitudinal} resolution of this cell
+           in a L{Resolutions2Tuple}C{(res1, res2)}, both in C{degrees}.
+        '''
+        return resolution2(self.precision, self.precision)
+
     @deprecated_property_RO
     def sizes(self):
         '''DEPRECATED on 2024.07.28, use property C{Geohash.sizes3}.'''
@@ -515,11 +522,11 @@ class Geohash(Str):
 
     @Property_RO
     def sizes3(self):
-        '''Get the lat-, longitudinal and radial size of this cell as
-           a L{Sizes3Tuple}C{(height, width, radius)}, all C{meter}.
+        '''Get the lat-, longitudinal and radial size of this cell in
+           a L{Sizes3Tuple}C{(height, width, radius)}, all in C{meter}.
         '''
         z = _GH.Sizes
-        n =  min(len(z) - 1, max(self.precision, 1))
+        n =  min(max(self.precision, 1), len(z) - 1)
         return Sizes3Tuple(z[n], name=self.name)
 
     def toLatLon(self, LatLon=None, **LatLon_kwds):
@@ -650,7 +657,7 @@ class Geohashed(object):
     def _ab2round(self, *ll):
         '''(INTERNAL) Make encoded keys C{a, b}.
         '''
-        return map(round, ll, self._nn)
+        return map(round, ll, self._nn)  # strict=True
 
     def clear(self):
         '''Clear the C{en-} and C{decoded} cache.
@@ -1007,8 +1014,8 @@ def resolution2(prec1, prec2=None):
                      (C{int} 1..12).
 
        @return: L{Resolutions2Tuple}C{(res1, res2)} with the
-                (geographic) resolutions C{degrees}, where C{res2
-                B{is} res1} if no B{C{prec2}} is given.
+                (geographic) resolutions in C{degrees}, where
+                C{res2 B{is} res1} if no B{C{prec2}} is given.
 
        @raise GeohashError: Invalid B{C{prec1}} or B{C{prec2}}.