Package pygeodesy3 :: Package ellipsoidal :: Module nvector :: Class LatLon

Class LatLon

        object --+                
                 |                
miscs.named._Named --+            
                     |            
miscs.named._NamedBase --+        
                         |        
    Base.latlon.LatLonBase --+    
                             |    
Base.nvector.LatLonNvectorBase --+
                                 |
        object --+               |
                 |               |
miscs.named._Named --+           |
                     |           |
miscs.named._NamedBase --+       |
                         |       |
    Base.latlon.LatLonBase --+   |
                             |   |
    Base.LatLonEllipsoidalBase --+
                                 |
                                LatLon

An n-vector-based, ellipsoidal LatLon point.

Instance Methods

deltaTo(self, other, wrap=False, **Ned_and_kwds)
Calculate the local delta from this to an other point.

destinationNed(self, delta)
Calculate the destination point using the supplied NED delta from this point.

distanceTo(self, other, radius=None, wrap=False)
Approximate the distance from this to an other point.

isequalTo(self, other, eps=None)
Compare this point with an other point.

intermediateTo(self, other, fraction, height=None, wrap=False)
Return the point at given fraction between this and an other point.

toCartesian(self, **Cartesian_and_kwds)
Convert this point to an Nvector-based geodetic point.

toNvector(self, **Nvector_and_kwds)
Convert this point to Nvector components, including height.

Inherited from Base.nvector.LatLonNvectorBase: intersections2, others, triangulate, trilaterate, trilaterate5

Inherited from Base.LatLonEllipsoidalBase: __init__, antipode, distanceTo2, elevation2, ellipsoid, ellipsoids, geoidHeight2, intersection3, isenclosedBy, midpointTo, nearestOn, parse, toCss, toDatum, toEtm, toLcc, toMgrs, toOsgr, toRefFrame, toTransform, toUps, toUtm, toUtmUps

Inherited from Base.latlon.LatLonBase: PointsIter, __eq__, __ne__, __str__, boundsOf, chordTo, circin6, circum3, circum4_, compassAngleTo, cosineAndoyerLambertTo, cosineForsytheAndoyerLambertTo, cosineLawTo, destinationXyz, equirectangularTo, euclideanTo, flatLocalTo, flatPolarTo, hartzell, haversineTo, height4, heightStr, hubenyTo, intersecant2, isantipodeTo, isequalTo3, latlon2, nearestOn6, nearestTo, normal, philam2, points2, radii11, rhumbAzimuthTo, rhumbDestination, rhumbDistanceTo, rhumbIntersecant2, rhumbLine, rhumbMidpointTo, thomasTo, toEcef, toLocal, toLtp, toNormal, toStr, toVector, toVector3d, toWm, vincentysTo

Inherited from miscs.named._NamedBase: __repr__, toRepr

Inherited from miscs.named._Named: __imatmul__, __matmul__, __rmatmul__, attrs, classof, copy, dup, methodname, rename

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __setattr__, __sizeof__, __subclasshook__

Properties

Ecef
Get the ECEF class (EcefVeness), once.

Inherited from Base.LatLonEllipsoidalBase: Equidistant, datum, ellipsoidalLatLon, epoch, gamma, iteration, reframe, scale

Inherited from Base.latlon.LatLonBase: clipid, height, isEllipsoidal, isSpherical, isnormal, lam, lat, latlon, latlonheight, lon, phi, philam, philamheight, sphericalLatLon, xyz, xyzh

Inherited from miscs.named._Named: classname, classnaming, name, named, named2, named3, named4, sizeof

Inherited from object: __class__

Method Details

deltaTo (self, other, wrap=False, **Ned_and_kwds)

Calculate the local delta from this to an other point.

Arguments:

other - The other point (LatLon).
wrap - If True, wrap or normalize the other point (bool).
Ned_and_kwds - Optional keyword arguments Ned=Ned, name=NN with the class to return delta, name and and possibly other Ned keyword arguments.

Returns:

Delta from this to the other point (Ned).

Raises:

TypeError - The other point is not LatLon or Ned is invalid.
ValueError - If ellipsoids are incompatible.

Note: This is a linear delta, unrelated to a geodesic on the ellipsoid.

destinationNed (self, delta)

Calculate the destination point using the supplied NED delta from this point.

Arguments:

delta - Delta from this to the other point in the local tangent plane (LTP) of this point (Ned).

Returns:

Destination point (LatLon).

Raises:

TypeError - If delta is not pygeodesy3.Ned.

distanceTo (self, other, radius=None, wrap=False)

Approximate the distance from this to an other point.

Arguments:

other - The other point (LatLon).
radius - Mean earth radius, ellipsoid or datum (meter, Ellipsoid, Ellipsoid2, Datum or a_f2Tuple), overriding the mean radius R1 of this point's datum..
wrap - If True, wrap or normalize and unroll the other and angular distance (bool).

Returns:

Distance (meter, same units as radius).

Raises:

TypeError - The other point is not LatLon.
ValueError - Invalid radius.

isequalTo (self, other, eps=None)

Compare this point with an other point.

Arguments:

other - The other point (LatLon).
eps - Optional margin (float).

Returns:

True if points are identical, including datum, ignoring height, False otherwise.

Raises:

TypeError - The other point is not LatLon.
ValueError - Invalid eps.

Overrides: Base.latlon.LatLonBase.isequalTo

See Also: Method isequalTo3 to include height.

intermediateTo (self, other, fraction, height=None, wrap=False)

Return the point at given fraction between this and an other point.

Arguments:

other - The other point (LatLon).
fraction - Fraction between both points (scalar, 0.0 at this to 1.0 at the other point.
height - Optional height, overriding the fractional height (meter).
wrap - If True, wrap or normalize the other point (bool).

Returns:

Intermediate point (LatLon).

Raises:

TypeError - The other point is not LatLon.

Overrides: Base.LatLonEllipsoidalBase.intermediateTo

toCartesian (self, **Cartesian_and_kwds)

Convert this point to an Nvector-based geodetic point.

Arguments:

Cartesian_and_kwds - Optional Cartesian, datum and other keyword arguments. Use Cartesian=... to override this Cartesian class or specify Cartesian=None.

Returns:

The geodetic point (Cartesian) or if Cartesian is set to None, an Ecef9Tuple

(x, y, z, lat, lon, height, C, 
          M, datum)

with C and M if available.

Raises:

TypeError - Invalid Cartesian or other Cartesian_and_kwds.

Overrides: Base.latlon.LatLonBase.toCartesian

toNvector (self, **Nvector_and_kwds)

Convert this point to Nvector components, including height.

Arguments:

Nvector_and_kwds - Optional Nvector, datum and other keyword arguments. Use Nvector=... to override this Nvector class or specify Nvector=None.

Returns:

The n-vector components (Nvector) or if Nvector is set to None, a Vector4Tuple(x, y, z, h).

Raises:

TypeError - Invalid Nvector or other Nvector_and_kwds.

Overrides: Base.latlon.LatLonBase.toNvector

Property Details

Ecef

Get the ECEF class (EcefVeness), once.

Get method:: Ecef(self) - Get the ECEF class (EcefVeness), once.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.