Package pygeodesy :: Module azimuthal :: Class GnomonicKarney |
[frames] | no frames]

# Class GnomonicKarney

      object --+
               |
    named._Named --+
                   |
    named._NamedBase --+
                       |
          _AzimuthalBase --+
                           |
        _AzimuthalBaseKarney --+
                               |
                              GnomonicKarney

Azimuthal gnomonic projection, a Python version of Karney's C++ class Gnomonic, requiring package geographiclib to be installed.

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 GnomonicKarney projection. |
forward(self, lat, lon, name=`'````'`, raiser=True) Convert an (ellipsoidal) geodetic location to azimuthal gnomonic east- and northing. |
reverse(self, x, y, name=`'````'`, LatLon=None, **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`: `_dot_`, `attrs`, `classof`, `copy`, `toStr2` Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__setattr__`, `__sizeof__`, `__subclasshook__`

Properties
Inherited from `_AzimuthalBaseKarney`: `geodesic` Inherited from `_AzimuthalBase`: `datum`, `equatoradius`, `flattening`, `iteration`, `lat0`, `latlon0`, `lon0`, `majoradius`, `radius` Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2`, `named3`, `named4` Inherited from `object`: `__class__`

Method Details

### __init__ (self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, name=`'````'`) (Constructor) |
New azimuthal GnomonicKarney 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 for the projection (`str`). Raises: `ImportError` - Package geographiclib missing. `AzimuthalError` - Invalid `lat0` or `lon0`. Overrides: object.__init__

### forward (self, lat, lon, name=`'````'`, raiser=True) |
Convert an (ellipsoidal) geodetic location to azimuthal gnomonic east- and northing. Arguments: `lat` - Latitude of the location (`degrees90`). `lon` - Longitude of the location (`degrees180`). `name` - Optional name for the location (`str`). `raiser` - Do or don't throw an error (`bool`) if the location lies over the horizon. Returns: An Azimuthal7Tuple`(x, y, lat, lon, azimuth, scale, datum)` with `x` and `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` is `False`. Raises: `AzimuthalError` - Invalid `lat`, `lon` or the geodetic location lies over the horizon and `raiser` is `True`.

### reverse (self, x, y, name=`'````'`, LatLon=None, **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`). `name` - Optional name for the location (`str`). `LatLon` - Class to use (`LatLon`) or `None`. `LatLon_kwds` - Optional, additional `LatLon` keyword arguments, ignored if `LatLon=None`. Returns: The geodetic (`LatLon`) or if `LatLon` is `None` an Azimuthal7Tuple`(x, y, lat, lon, azimuth, scale, datum)`. Raises: `AzimuthalError` - No convergence. 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.