Package pygeodesy :: Module nvectorBase :: Class LatLonNvectorBase

Class LatLonNvectorBase

   object --+            
            |            
 named._Named --+        
                |        
 named._NamedBase --+    
                    |    
latlonBase.LatLonBase --+
                        |
                       LatLonNvectorBase

Known Subclasses:

(INTERNAL) Base class for n-vector-based ellipsoidal and spherical LatLon classes.

Instance Methods

intersections2(self, radius1, other, radius2, **kwds)
Not implemented, throws a NotImplementedError always.

others(self, *other, **name_other_up)
Refined class comparison.

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

triangulate(self, bearing1, other, bearing2, height=None, wrap=False)
Locate a point given this, an other point and the (initial) bearing from this and the other point.

trilaterate(self, distance1, point2, distance2, point3, distance3, radius=6371008.771415, height=None, useZ=False, wrap=False)
Locate a point at given distances from this and two other points.

trilaterate5(self, distance1, point2, distance2, point3, distance3, area=False, eps=0.9999999999999998, radius=6371008.771415, wrap=False)
Not implemented for area=True and falls back to method trilaterate otherwise.

Inherited from latlonBase.LatLonBase: PointsIter, __eq__, __init__, __ne__, __str__, antipode, bounds, boundsOf, chordTo, circin6, circum3, circum4_, compassAngle, compassAngleTo, cosineAndoyerLambertTo, cosineForsytheAndoyerLambertTo, cosineLawTo, destinationXyz, equals, equals3, equirectangularTo, euclideanTo, flatLocalTo, flatPolarTo, hartzell, haversineTo, height4, heightStr, hubenyTo, intersecant2, isantipode, isantipodeTo, isequalTo, isequalTo3, latlon2, latlon2round, latlon_, nearestOn6, nearestTo, normal, philam2, points, points2, radii11, rhumbAzimuthTo, rhumbDestination, rhumbDistanceTo, rhumbIntersecant2, rhumbLine, rhumbMidpointTo, thomasTo, to2ab, to3llh, to3xyz, toCartesian, toDatum, toEcef, toLocal, toLtp, toNormal, toStr, toVector, toVector3d, toWm, vincentysTo

Inherited from named._NamedBase: __repr__, toRepr

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

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

Properties

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

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

Inherited from object: __class__

Method Details

others (self, *other, **name_other_up)

Refined class comparison.

Arguments:

other - The other instance (LatLonNvectorBase).
name_other_up - Overriding name=other and up=1 keyword arguments.

Returns:

The other if compatible.

Raises:

TypeError - Incompatible other type.

Overrides: named._NamedBase.others

toNvector (self, **Nvector_and_kwds)

Convert this point to Nvector components, including height.

Arguments:

Nvector_and_kwds - Optional Nvector class and Nvector keyword arguments, Specify Nvector=... to override this Nvector class or use Nvector=None.

Returns:

An Nvector or if Nvector is None, a Vector4Tuple(x, y, z, h).

Raises:

TypeError - Invalid Nvector or other Nvector_and_kwds item.

Overrides: latlonBase.LatLonBase.toNvector

triangulate (self, bearing1, other, bearing2, height=None, wrap=False)

Locate a point given this, an other point and the (initial) bearing from this and the other point.

Arguments:

bearing1 - Bearing at this point (compass degrees360).
other - The other point (LatLon).
bearing2 - Bearing at the other point (compass degrees360).
height - Optional height at the triangulated point, overriding the mean height (meter).
wrap - If True, use this and the other point normalized (bool).

Returns:

Triangulated point (LatLon).

Raises:

TypeError - Invalid other point.
Valuerror - Points coincide.

trilaterate (self, distance1, point2, distance2, point3, distance3, radius=6371008.771415, height=None, useZ=False, wrap=False)

Locate a point at given distances from this and two other points.

Arguments:

distance1 - Distance to this point (meter, same units as radius).
point2 - Second reference point (LatLon).
distance2 - Distance to point2 (meter, same units as radius).
point3 - Third reference point (LatLon).
distance3 - Distance to point3 (meter, same units as radius).
radius - Mean earth radius (meter).
height - Optional height at trilaterated point, overriding the mean height (meter, same units as radius).
useZ - Include Z component iff non-NaN, non-zero (bool).
wrap - If True, use this, point2 and point3 normalized (bool).

Returns:

Trilaterated point (LatLon).

Raises:

IntersectionError - No intersection, trilateration failed.
TypeError - Invalid point2 or point3.
ValueError - Some points coincide or invalid distance1, distance2, distance3 or radius.

See Also: Trilateration, Veness' JavaScript Trilateration and method LatLon.trilaterate5 of other, non-Nvector LatLon classes.

trilaterate5 (self, distance1, point2, distance2, point3, distance3, area=False, eps=0.9999999999999998, radius=6371008.771415, wrap=False)

Not implemented for area=True and falls back to method trilaterate otherwise.

Returns:

A Trilaterate5Tuple

(min, minPoint, max, 
          maxPoint, n)

with a single trilaterated intersection minPoint is maxPoint,

min is 
          max

the nearest intersection margin and count

n = 
          1

Raises:

NotImplementedError - Keyword argument area=True not (yet) supported.

See Also: Method trilaterate for other and more details.