Package pygeodesy :: Module geodesici

Module geodesici

Classes Intersectool and Intersector to find the intersections of two geodesic lines or line segments.

Class Intersector is a pure Python version of Karney's C++ class Intersect.

Class Intersectool is a wrapper to invoke Karney's IntersectTool utility, but intended for testing purposes only.

Set env variable PYGEODESY_INTERSECTTOOL to the (fully qualified) path of the IntersectTool executable. For usage and some examples run "env PYGEODESY_INTERSECTTOOL=<IntersectTool-path> python3 -m pygeodesy.geodesici --help".

Both Intersectool and Intersector provide methods All, Closest, Next and Segment and produce XDict instances with 4 or more items. Adjacent methods All5, Closest5, Next5 and Segment return or yield Intersectool5Tuple or Intersector5Tuples with the lat-, longitude and azimuth of each intersection as an extended, geodesic Position-like GDict instance.

For more details, see the C++ GeographicLib documentation, Charles F.F. Karney's paper Geodesics intersections and S. Baselga Moreno & J.C. Martinez-Llario's Intersection and point-to-line solutions for geodesics on the ellipsoid.

Version: 24.12.22

Classes
	XDict 4+Item result from Intersectool and Intersector methods `All`, `Closest`, `Next` and `Segment` with the intersection offsets `sA`, `sB` and `sX0` in `meter` and the coincidence indicator `c`, an `int`, +1 for parallel, -1 for anti-parallel or 0 otherwise.
	_IntersectBase (INTERNAL) Base class for Intersectool and Intersector.
	Intersectool Wrapper to invoke Karney's utility IntersectTool similar to class Intersector.
	Intersector Finder of intersections between two goedesic lines, each an instance of GeodesicLineExact, wrapped GeodesicLine or GeodesicLineSolve.
	Intersect7Tuple 7-Tuple `(A, B, sAB, aAB, c, kA, kB)` with `A` and `B` each a `LatLon` or LatLon4Tuple`(lat, lon, height, datum)` of the intersection on each geodesic line, the distance `sAB` in in `meter` and angular distance `aAB` in `degrees` between `A` and `B`, coincidence indicator `c` and segment indicators `kA` and `kB` all `int`, see XDict and method intersect7.
	Intersectool5Tuple 5-Tuple `(A, B, sAB, aAB, c)` with `A` and `B` the `Position` of the intersection on each geodesic line, the distance `sAB` between `A` and `B` in `meter`, the angular distance `aAB` in `degrees` and coincidence indicator `c` (`int`), see XDict.
	Intersector5Tuple 5-Tuple `(A, B, sAB, aAB, c)` with `A` and `B` the `Position` of the intersection on each geodesic line, the distance `sAB` between `A` and `B` in `meter`, angular distance `aAB` in `degrees` and coincidence indicator `c` (`int`), see XDict.
	Middle5Tuple 5-Tuple `(A, B, sMM, aMM, c)` with `A` and `B` the line segments including the mid-point location in `latM`, `lonM`, distance `s1M` in `meter` and angular distance `a1M` in `degrees`, the distance between both mid-points `sMM` in `meter` and angular distance `aMM` in `degrees` and coincidence indicator `c` (`int`).

Variables
	__all__ = `_ALL_LAZY.geodesici`