Package pygeodesy3 :: Package geodesic

Package geodesic

Pure Python versions of three Karney geodesics, C++ class GeodesicExact, GeodSolve utility and Python package geographiclib, provided that package is installed.

Version: 23.12.18

Submodules

pygeodesy3.geodesic.exact: A pure Python version of Karney's C++ classes GeodesicExact and GeodesicLineExact.
- pygeodesy3.geodesic.exact._C4_24: A Python version of part of Karney's C++ module GeodesicExactC4.
- pygeodesy3.geodesic.exact._C4_27: A Python version of part of Karney's C++ module GeodesicExactC4.
- pygeodesy3.geodesic.exact._C4_30: A Python version of part of Karney's C++ module GeodesicExactC4.
- pygeodesy3.geodesic.exact.__main__: Print geodesic.exact version, etc.
- pygeodesy3.geodesic.exact.gx: A pure Python version of Karney's C++ class GeodesicExact.
- pygeodesy3.geodesic.exact.gxBases: (INTERNAL) Private geodesic.wrap base class, functions and constants.
- pygeodesy3.geodesic.exact.gxarea: Slightly enhanced versions of classes PolygonArea and Accumulator from Karney's Python geographiclib.
- pygeodesy3.geodesic.exact.gxline: A pure Python version of Karney's C++ class GeodesicLineExact.
pygeodesy3.geodesic.solve: Wrapper to invoke Karney's GeodSolve utility as an (exact) geodesic, but intended for testing purposes only.
pygeodesy3.geodesic.wrap: Wrapper around Python classes geodesic.Geodesic and geodesicline.GeodesicLine from Karney's Python package geographiclib, provided that package is installed.

Classes
	GeodSolve12Tuple 12-Tuple `(lat1, lon1, azi1, lat2, lon2, azi2, s12, a12, m12, M12, M21, S12)` with angles `lat1`, `lon1`, `azi1`, `lat2`, `lon2` and `azi2` and arc `a12` all in `degrees`, initial `azi1` and final `azi2` forward azimuths, distance `s12` and reduced length `m12` in `meter`, area `S12` in `meter` squared and geodesic scale factors `M12` and `M21`, both `scalar`, see GeodSolve.
	GeodesicAreaExact Area and perimeter of a geodesic polygon, an enhanced version of Karney's Python class PolygonArea using the more accurate surface area.
	GeodesicExact A pure Python version of Karney's C++ class GeodesicExact, modeled after Karney's Python class geodesic.Geodesic.
	GeodesicLineExact A pure Python version of Karney's C++ class GeodesicLineExact, modeled after Karney's Python class geodesicline.GeodesicLine.
	GeodesicLineSolve Wrapper to invoke Karney's GeodSolve as an `Exact` version of Karney's Python class GeodesicLine.
	GeodesicSolve Wrapper to invoke Karney's GeodSolve as an `Exact` version of Karney's Python class Geodesic.
	PolygonArea For `geographiclib` compatibility, sub-class of GeodesicAreaExact.

Functions

Geodesic(a_ellipsoid, f=None, name='')
Return a wrapped geodesic.Geodesic instance from Karney's Python geographiclib, provide the latter is installed, otherwise an ImportError.

GeodesicLine(geodesic, lat1, lon1, azi1, caps=3979)
Return a wrapped geodesicline.GeodesicLine instance from Karney's Python geographiclib, provided the latter is installed, otherwise an ImportError.

Geodesic_WGS84()
Get the wrapped Geodesic(WGS84) singleton, provided geographiclib is installed, otherwise an ImportError.

Variables
	__getattr__ = `_lazy_import_as(__name__)`

Function Details

Geodesic (a_ellipsoid, f=None, name='')

Return a wrapped geodesic.Geodesic instance from Karney's Python geographiclib, provide the latter is installed, otherwise an ImportError.

Arguments:

a_ellipsoid - An ellipsoid (Ellipsoid) or datum (Datum) or the equatorial radius a of the ellipsoid (meter).
f - The flattening of the ellipsoid (scalar), ignored if a_ellipsoid) is not specified as meter.
name - Optional ellipsoid name (str), ignored like f.

GeodesicLine (geodesic, lat1, lon1, azi1, caps=3979)

Return a wrapped geodesicline.GeodesicLine instance from Karney's Python geographiclib, provided the latter is installed, otherwise an ImportError.

Arguments:

geodesic - A wrapped Geodesic instance.
lat1 - Latitude of the first points (degrees).
lon1 - Longitude of the first points (degrees).
azi1 - Azimuth at the first points (compass degrees360).
caps - Optional, bit-or'ed combination of Caps values specifying the capabilities the GeodesicLine instance should possess, i.e., which quantities can be returned by calls to GeodesicLine.Position and GeodesicLine.ArcPosition.