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

# Class _AlbersBase

      object --+
               |
    named._Named --+
                   |
    named._NamedBase --+
                       |
                      _AlbersBase

Known Subclasses:
  - AlbersEqualArea
  - , AlbersEqualArea2
  - , AlbersEqualArea4
  - , AlbersEqualAreaCylindrical
  - , AlbersEqualAreaNorth
  - , AlbersEqualAreaSouth

(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`, `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 (major) radius, semi-axis (`meter`).
| majoradius Get the geodesic's equatorial (major) 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`).
| scale0 Get the central scale for the projection (`float`).
Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2` 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: `AlbersError` - Invalid `lat` or `k`. 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: datum(self) - Get the datum (Datum). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### equatoradius Get the geodesic's equatorial (major) radius, semi-axis (`meter`). Get method: equatoradius(self) - Get the geodesic's equatorial (major) radius, semi-axis (`meter`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### majoradius Get the geodesic's equatorial (major) radius, semi-axis (`meter`). Get method: equatoradius(self) - Get the geodesic's equatorial (major) radius, semi-axis (`meter`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### iteration Get the iteration number (`int`). Get method: iteration(self) - Get the iteration number (`int`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### flattening Get the geodesic's flattening (`float`). Get method: flattening(self) - Get the geodesic's flattening (`float`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### ispolar Is this projection polar (`bool`)? Get method: ispolar(self) - Is this projection polar (`bool`)? Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### 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: lat0(self) - Get the latitude of the projection origin (`degrees`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### lat1 Get the latitude of the first parallel (`degrees`). Get method: lat1(self) - Get the latitude of the first parallel (`degrees`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.

### lat2 Get the latitude of the second parallel (`degrees`). Get method: lat2(self) - Get the latitude of the second parallel (`degrees`). Set method: immutable(inst, value) - Throws an `AttributeError`, always. Note: The second and first parallel latitudes are the same instance for 1-parallel `AlbersEqualArea*` projections.

### 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: scale0(self) - Get the central scale for the projection (`float`). Set method: immutable(inst, value) - Throws an `AttributeError`, always.