Package pygeodesy :: Module azimuthal :: Class Stereographic

Class Stereographic

  object --+            
           |            
named._Named --+        
               |        
named._NamedBase --+    
                   |    
      _AzimuthalBase --+
                       |
                      Stereographic

Stereographic projection for the sphere***, see Snyder, pp 157-160 and MathWorld-Wolfram.

Instance Methods

__init__(self, lat0, lon0, datum=None, name='')
New azimuthal projection.

forward(self, lat, lon, name='')
Convert a geodetic location to azimuthal stereographic east- and northing.

reverse(self, x, y, name='', **LatLon_and_kwds)
Convert an azimuthal stereographic location to 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, toStr2

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

Properties

k0
Class property with retrievable name.

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=None, name='')
(Constructor)

New azimuthal 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 for the projection (str).

Raises:

AzimuthalError - Invalid lat0 or lon0 or (spherical) datum.
TypeError - Invalid datum.

Overrides: object.__init__

forward (self, lat, lon, name='')

Convert a geodetic location to azimuthal stereographic east- and northing.

Arguments:

lat - Latitude of the location (degrees90).
lon - Longitude of the location (degrees180).
name - Optional name for the location (str).

Returns:

An Azimuthal7Tuple

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

with easting x and northing y of point in meter and lat and lon in degrees and azimuth clockwise from true North. The scale of the projection is 1 in radial direction and is 1 / reciprocal in the direction perpendicular to this.

Raises:

AzimuthalError - Invalid lat or lon.

Overrides: _AzimuthalBase.forward

reverse (self, x, y, name='', **LatLon_and_kwds)

Convert an azimuthal stereographic location to 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_and_kwds - Optional, LatLon=None class to use and additional LatLon keyword arguments, ignored if LatLon is None or not given.

Returns:

The geodetic (LatLon) or if LatLon is None an Azimuthal7Tuple

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

Overrides: _AzimuthalBase.reverse

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

Property Details

k0

Class property with retrievable name.

Get method:: k0(self) - Get the central scale factor (scalar).
Set method:: k0(self, factor) - Set the central scale factor (scalar).

Class Stereographic

__init__ (self, lat0, lon0, datum=None, name='') (Constructor)

forward (self, lat, lon, name='')

reverse (self, x, y, name='', **LatLon_and_kwds)

k0

init (self, lat0, lon0, datum=None, name='')
(Constructor)