Package pygeodesy :: Module azimuthal :: Class _GnomonicBase

Class _GnomonicBase

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

Known Subclasses:

(INTERNAL) Base for classes GnomonicExact, GnomonicGeodSolve and GnomonicKarney.

Instance Methods

__init__(self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., **name)
New azimuthal GnomonicExact or GnomonicKarney 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: __format__, __imatmul__, __matmul__, __rmatmul__, attrs, classof, copy, dup, methodname, rename, renamed, toStr2

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

Properties

Inherited from _AzimuthalGeodesic: 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 or GnomonicKarney projection.

Arguments:

lat0 - Latitude of the center point (degrees90).
lon0 - Longitude of the 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 or (spherical) datum.
TypeError - Invalid datum.

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 optionally, 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.

Class _GnomonicBase

__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)

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