Package pygeodesy :: Module albers :: Class _AlbersBase
[frames] | no frames]

Class _AlbersBase

  object --+        
           |        
named._Named --+    
               |    
named._NamedBase --+
                   |
                  _AlbersBase
Known Subclasses:

(INTERNAL) Base class for AlbersEqualArea... projections.


See Also: Karney's C++ class AlbersEqualArea, method Init.

Instance Methods
 
__init__(self, sa1, ca1, sa2, ca2, k, datum, name)
(INTERNAL) New AlbersEqualArea... instance.
 
forward(self, lat, lon, lon0=0, name='')
Convert a geodetic location to east- and northing.
 
rescale0(self, lat, k=1)
Set the azimuthal scale for this projection.
 
reverse(self, x, y, lon0=0, name='', LatLon=None, **LatLon_kwds)
Convert an east- and northing location to geodetic lat- and longitude.
 
_k0_(self, k)
(INTERNAL) Set ._k0, ._k02, etc.

Inherited from named._NamedBase: __repr__, __str__, others, toRepr, toStr

Inherited from named._Named: _DOT_, attrs, classof, copy, rename, toStr2

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

Properties
  datum
Get the datum (Datum).
  equatoradius
Get the geodesic's equatorial radius, semi-axis (meter).
  iteration
Get the iteration number (int).
  flattening
Get the geodesic's flattening (float).
  ispolar
Is this projection polar (bool)?
  isPolar
Is this projection polar (bool)?
  lat0
Get the latitude of the projection origin (degrees).
  lat1
Get the latitude of the first parallel (degrees).
  lat2
Get the latitude of the second parallel (degrees).
  majoradius
DEPRECATED, use property equatoradius.
  scale0
Get the central scale for the projection (float).

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

Inherited from object: __class__

Method Details

__init__ (self, sa1, ca1, sa2, ca2, k, datum, name)
(Constructor)

 

(INTERNAL) New AlbersEqualArea... instance.

Overrides: object.__init__

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

 

Convert a geodetic location to east- and northing.

Arguments:
  • lat - Latitude of the location (degrees).
  • lon - Longitude of the location (degrees).
  • lon0 - Optional central meridian longitude (degrees).
  • name - Optional name for the location (str).
Returns:
An Albers7Tuple(x, y, lat, lon, gamma, scale, datum).

Note: The origin latitude is returned by property lat0. No false easting or northing is added. The value of lat should be in the range [-90..90] degrees. The returned values x and y will be large but finite for points projecting to infinity, i.e. one or both of the poles.

rescale0 (self, lat, k=1)

 

Set the azimuthal scale for this projection.

Arguments:
  • lat - Northern latitude (degrees).
  • k - Azimuthal scale at latitude lat (scalar).
Raises:

Note: This allows a latitude of conformality to be specified.

reverse (self, x, y, lon0=0, name='', LatLon=None, **LatLon_kwds)

 

Convert an east- and northing location to geodetic lat- and longitude.

Arguments:
  • x - Easting of the location (meter).
  • y - Northing of the location (meter).
  • lon0 - Optional central meridian longitude (degrees).
  • 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 Albers7Tuple(x, y, lat, lon, gamma, scale, datum).

Note: The origin latitude is returned by property lat0. No false easting or northing is added. The returned value of lon is in the range [-180..180] degrees and lat is in the range [-90..90] degrees. If the given x or y point is outside the valid projected space the nearest pole is returned.


Property Details

datum

Get the datum (Datum).

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

equatoradius

Get the geodesic's equatorial radius, semi-axis (meter).

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

iteration

Get the iteration number (int).

Get method:
iteration(self) - Get the iteration number (int).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

flattening

Get the geodesic's flattening (float).

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

ispolar

Is this projection polar (bool)?

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

isPolar

Is this projection polar (bool)?

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

lat0

Get the latitude of the projection origin (degrees).

This is the latitude of minimum azimuthal scale and equals the lat in the 1-parallel AlbersEqualArea and lies between lat1 and lat2 for the 2-parallel AlbersEqualArea2 and AlbersEqualArea4 projections.

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

lat1

Get the latitude of the first parallel (degrees).

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

lat2

Get the latitude of the second parallel (degrees).

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

Note: The second and first parallel latitudes are the same instance for 1-parallel AlbersEqualArea* projections.

majoradius

DEPRECATED, use property equatoradius.

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)

scale0

Get the central scale for the projection (float).

This is the azimuthal scale on the latitude of origin of the projection, see property lat0.

Get method:
_fget(inst)
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst)