Module sphericalNvector

Check whether a polygon encloses a pole.

Arguments:

• points - The polygon points (LatLon[]).
• wrap - If True, wrap or normalize and unroll the points (bool).

Returns:

True if the polygon encloses a pole, False otherwise.

Raises:

• PointsError - Insufficient number of points
• TypeError - Some points are not LatLon or don't have bearingTo2, initialBearingTo and finalBearingTo methods.

Calculate the area of a (spherical) polygon or composite (with great circle arcs joining consecutive points).

Arguments:

• points - The polygon points or clips (LatLon[], BooleanFHP or BooleanGH).
• radius - Mean earth radius (meter) or None.
• wrap - If True, wrap or normalize and unroll the points (bool).

Returns:

Polygon area (meter squared , same units as radius, or radians if radius is None).

Raises:

• PointsError - Insufficient number of points.
• TypeError - Some points are not LatLon.

Compute the intersections of a circle and a (great circle) line given as two points or as a point and bearing.

Arguments:

• center - Center of the circle (LatLon).
• circle - Radius of the circle (meter, same units as radius) or a point on the circle (LatLon).
• point - A point on the (great circle) line (LatLon).
• other - An other point on the (great circle) line (LatLon) or the bearing at the point (compass degrees360).
• radius_exact_height_wrap - Optional keyword arguments, see method LatLon.intersecant2 for further details.

Returns:

2-Tuple of the intersection points (representing a chord), each an instance of the point class. Both points are the same instance if the (great circle) line is tangent to the circle.

Raises:

• IntersectionError - The circle and line do not intersect.
• TypeError - If center or point not LatLon or circle or other invalid.
• UnitError - Invalid circle, other, radius, exact, height or napieradius.

Locate the intersections of two (great circle) lines each defined by two points or by a start point and an (initial) bearing.

Arguments:

• start1 - Start point of the first line (LatLon).
• end1 - End point of the first line (LatLon) or the initial bearing at the first start point (compass degrees360).
• start2 - Start point of the second line (LatLon).
• end2 - End point of the second line (LatLon) or the initial bearing at the second start point (compass degrees360).
• height - Optional height at the intersection point, overriding the mean height (meter).
• wrap - If True, wrap or normalize and unroll start2 and both end* points (bool).
• LatLon - Optional class to return the intersection point (LatLon).
• LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

The intersection point (LatLon) or if LatLon is None, a cartesian Ecef9Tuple(x, y, z, lat, lon, height, C, M, datum) with C and M if available.

Raises:

• TypeError - If start* or end* is not LatLon.
• ValueError - Intersection is ambiguous or infinite or the lines are parallel, coincident or null.

Locate the intersections of two (great circle) lines each defined by two points or by a start point and an (initial) bearing.

Arguments:

• start1 - Start point of the first line (LatLon).
• end1 - End point of the first line (LatLon) or the initial bearing at the first start point (compass degrees360).
• start2 - Start point of the second line (LatLon).
• end2 - End point of the second line (LatLon) or the initial bearing at the second start point (compass degrees360).
• height - Optional height at the intersection and antipodal point, overriding the mean height (meter).
• wrap - If True, wrap or normalize and unroll start2 and both end* points (bool).
• LatLon - Optional class to return the intersection and antipodal points (LatLon).
• LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

2-Tuple (intersection, antipode), each a (LatLon) or if LatLon is None, a cartesian Ecef9Tuple(x, y, z, lat, lon, height, C, M, datum) with C and M if available.

Raises:

• TypeError - If start* or end* is not LatLon.
• ValueError - Intersection is ambiguous or infinite or the lines are parallel, coincident or null.

Compute the geographic mean of the supplied points.

Arguments:

• points - Array of points to be averaged (LatLon[]).
• height - Optional height, overriding the mean height (meter).
• wrap - If True, wrap or normalize points (bool).
• LatLon - Optional class to return the mean point (LatLon).
• LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

Point at geographic mean and mean height (LatLon).

Raises:

• PointsError - Insufficient number of points or some points are not LatLon.

DEPRECATED, use method sphericalNvector.nearestOn3.

Returns:

... 2-Tuple (closest, distance) of the closest point (LatLon) on the polygon and the distance between the closest and the given point ...

Decorators:

• @deprecated_function

Locate the point on a polygon (with great circle arcs joining consecutive points) closest to an other point.

If the given point is between the end points of a great circle arc, the closest point is on that arc. Otherwise, the closest point is the nearest of the arc's end points.

Arguments:

• point - The other, reference point (LatLon).
• points - The polygon points (LatLon[]).
• closed - Optionally, close the polygon (bool).
• radius - Mean earth radius (meter) or None.
• height - Optional height, overriding the mean height for a point within the (great circle) arc (meter).
• wrap - If True, wrap or normalize and unroll the points (bool).

Returns:

A NearestOn3Tuple(closest, distance, angle) of the closest point (LatLon) on the polygon, the distance and the angle between the closest and the given point. The distance is in meter, same units as radius or in radians if radius is None, the angle is in compass degrees360.

Raises:

• PointsError - Insufficient number of points.
• TypeError - Some points or point not LatLon.

Compute the perimeter of a (spherical) polygon or composite (with great circle arcs joining consecutive points).

Arguments:

• points - The polygon points (LatLon[]).
• closed - Optionally, close the polygon (bool).
• radius - Mean earth radius (meter) or None.
• wrap - If True, wrap or normalize and unroll the points (bool).

Returns:

Polygon perimeter (meter, same units as radius or radians if radius is None).

Raises:

• PointsError - Insufficient number of points.
• TypeError - Some points are not LatLon.
• ValueError - Invalid radius or closed=False with points a composite.

Return the vectorial sum of two or more n-vectors.

Arguments:

• nvectors - Vectors to be added (Nvector[]).
• Vector - Optional class for the vectorial sum (Nvector).
• h - Optional height, overriding the mean height (meter).
• Vector_kwds - Optional, additional Vector keyword arguments.

Returns:

Vectorial sum (Vector).

Raises:

• VectorError - No nvectors.

Locate a point given two known points and the (initial) bearing from those points.

Arguments:

• point1 - First reference point (LatLon).
• bearing1 - Bearing at the first point (compass degrees360).
• point2 - Second reference point (LatLon).
• bearing2 - Bearing at the second point (compass degrees360).
• height - Optional height at the triangulated point, overriding the mean height (meter).
• wrap - If True, wrap or normalize and unroll point2 (bool).
• LatLon - Optional class to return the triangulated point (LatLon).
• LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

Triangulated point (LatLon).

Raises:

• TypeError - If point1 or point2 is not LatLon.
• Valuerror - Points coincide.

Locate a point at given distances from three other points.

Arguments:

• point1 - First point (LatLon).
• distance1 - Distance to the first point (meter, same units as radius).
• point2 - Second point (LatLon).
• distance2 - Distance to the second point (meter, same units as radius).
• point3 - Third point (LatLon).
• distance3 - Distance to the third point (meter, same units as radius).
• radius - Mean earth radius (meter).
• height - Optional height at the trilaterated point, overriding the IDW height (meter, same units as radius).
• useZ - Include Z component iff non-NaN, non-zero (bool).
• wrap - If True, wrap or normalize and unroll point2 and point3 (bool).
• LatLon - Optional class to return the trilaterated point (LatLon).
• LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

Trilaterated point (LatLon).

Raises:

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