Package pygeodesy :: Module azimuthal :: Class GnomonicExact

Class GnomonicExact

  object --+                    
           |                    
named._Named --+                
               |                
named._NamedBase --+            
                   |            
      _AzimuthalBase --+        
                       |        
      _AzimuthalGeodesic --+    
                           |    
               _GnomonicBase --+
                               |
                              GnomonicExact

Azimuthal gnomonic projection, a Python version of Karney's C++ class Gnomonic, based on exact geodesic classes GeodesicExact and GeodesicLineExact.

See Also: Karney's Detailed Description, especially the Warning.

Instance Methods

__init__(self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., **name)
New azimuthal GnomonicExact projection.

forward(self, lat, lon, raiser=True, **name)
Convert an (ellipsoidal) geodetic location to azimuthal gnomonic east- and northing.

reverse(self, x, y, LatLon=None, **name_LatLon_kwds)
Convert an azimuthal gnomonic location to (ellipsoidal) geodetic lat- and longitude.

Inherited from _AzimuthalBase: reset, toRepr, toStr

Inherited from named._NamedBase: __repr__, __str__, others

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

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

Properties

geodesic

Inherited from _AzimuthalBase: a, datum, equatoradius, f, flattening, lat0, latlon0, lon0, majoradius, radius

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

Inherited from object: __class__

Method Details

init (self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, **name)
(Constructor)

New azimuthal GnomonicExact projection.

Arguments:

lat0 - Latitude of center point (degrees90).
lon0 - Longitude of center point (degrees180).
datum - Optional datum or ellipsoid (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple) or scalar earth radius (meter).
name - Optional name=NN for the projection (str).

Raises:

AzimuthalError - Invalid lat0 or lon0.

Overrides: object.__init__

forward (self, lat, lon, raiser=True, **name)

Convert an (ellipsoidal) geodetic location to azimuthal gnomonic east- and northing.

Arguments:

lat - Latitude of the location (degrees90).
lon - Longitude of the location (degrees180).
raiser - Do or don't throw an error (bool) if the location lies over the horizon.
name - Optional name=NN for the location (str).

Returns:

An Azimuthal7Tuple

(x, y, lat, lon, azimuth, 
          scale, datum)

with easting x and northing y in meter and lat and lon in degrees and azimuth clockwise from true North. The scale of the projection is 1 / reciprocal**2 in radial direction and 1 / reciprocal in the direction perpendicular to this. Both x and y will be NAN if the (geodetic) location lies over the horizon and raiser=False.

Raises:

AzimuthalError - Invalid lat, lon or the location lies over the horizon and raiser=True.

Overrides: _AzimuthalBase.forward

reverse (self, x, y, LatLon=None, **name_LatLon_kwds)

Convert an azimuthal gnomonic location to (ellipsoidal) geodetic lat- and longitude.

Arguments:

x - Easting of the location (meter).
y - Northing of the location (meter).
LatLon - Class to use (LatLon) or None.
name_LatLon_kwds - Optional name=NN for the location and optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

The geodetic (LatLon) or if

LatLon is 
          None

an Azimuthal7Tuple

(x, y, lat, lon, azimuth, 
          scale, datum)

Raises:

AzimuthalError - No convergence.

Overrides: _AzimuthalBase.reverse

Note: The lat will be in the range [-90..90] degrees and lon in the range [-180..180] degrees. The azimuth is clockwise from true North. The scale is 1 / reciprocal**2 in radial direction and 1 / reciprocal in the direction perpendicular to this.

Property Details

geodesic

Get method:: _fget(inst) - Get and cache/memoize the property value.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

Class GnomonicExact

__init__ (self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., **name) (Constructor)

forward (self, lat, lon, raiser=True, **name)

reverse (self, x, y, LatLon=None, **name_LatLon_kwds)

geodesic

init (self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, **name)
(Constructor)