Package pygeodesy :: Module webmercator :: Class Wm |
[frames] | no frames]

# Class Wm

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

Web Mercator (WM) coordinate.

Instance Methods
__init__(self, x, y, radius=6378137.0, name=`'````'`) New Wm Web Mercator (WM) coordinate. |
latlon2(self, datum=None) Convert this WM coordinate to a (geodetic) lat- and longitude. |
parseWM(self, strWM, name=`'````'`) Parse a string to a WM coordinate. |
to2ll(self, datum=None) DEPRECATED, use method `latlon2`. |
toLatLon(self, LatLon, datum=None) Convert this WM coordinate to a geodetic point. |
toStr(self, prec=3, sep=`'``` `'`, radius=False) Return a string representation of this WM coordinate. |
toStr2(self, prec=3, fmt=`'``[%s]``'`, sep=`'``,` `'`, radius=False) Return a string representation of this WM coordinate. |
Inherited from `named._NamedBase`: `__repr__`, `__str__`, `others` Inherited from `named._Named`: `_dot_`, `attrs`, `classof`, `copy` Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__setattr__`, `__sizeof__`, `__subclasshook__`

Properties
| radius An immutable property (`Read Only`).
| x An immutable property (`Read Only`).
| y An immutable property (`Read Only`).
Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2` Inherited from `object`: `__class__`

Method Details

### __init__(self, x, y, radius=6378137.0, name=`'````'`) (Constructor) |
New Wm Web Mercator (WM) coordinate. Parameters: `x` - Easting from central meridian (`meter`). `y` - Northing from equator (`meter`). `radius` - Optional earth radius (`meter`). `name` - Optional name (`str`). Raises: `WebMercatorError` - Invalid `x`, `y` or `radius`. Overrides: object.__init__ Example:
    >>> import pygeodesy
    >>> w = pygeodesy.Wm(448251, 5411932)

### latlon2(self, datum=None) |
Convert this WM coordinate to a (geodetic) lat- and longitude. Parameters: `datum` - Optional datum (`Datum`). Returns: A LatLon2Tuple`(lat, lon)`. Raises: `TypeError` - Non-ellipsoidal `datum`. See Also: Method `toLatLon`.

### parseWM(self, strWM, name=`'````'`) |
Parse a string to a WM coordinate. For more details, see function parseWM in this module webmercator.

### to2ll(self, datum=None) |
DEPRECATED, use method `latlon2`. Returns: A LatLon2Tuple`(lat, lon)`.

### toLatLon(self, LatLon, datum=None) |
Convert this WM coordinate to a geodetic point. Parameters: `LatLon` - Ellipsoidal (sub-)class to return the point (`LatLon`). `datum` - Optional datum for ellipsoidal or `None` for spherical `LatLon` (`Datum`). Returns: Point of this WM coordinate (`LatLon`). Raises: `TypeError` - If `LatLon` and `datum` are incompatible or if `datum` is not ellipsoidal. Example:
    >>> w = Wm(448251.795, 5411932.678)
    >>> from pygeodesy import sphericalTrigonometry as sT
    >>> ll = w.toLatLon(sT.LatLon)  # 43°39′11.58″N, 004°01′36.17″E

### toStr(self, prec=3, sep=`'``` `'`, radius=False) |
Return a string representation of this WM coordinate. Parameters: `prec` - Optional number of decimals, unstripped (`int`). `sep` - Optional separator to join (`str`). `radius` - Optionally, include radius (`bool` or `scalar`). Returns: This WM as "meter meter" (`str`) plus " radius" if `radius` is `True` or `scalar`. Raises: `WebMercatorError` - Invalid `radius`. Overrides: named._Named.toStr Example:
    >>> w = Wm(448251, 5411932.0001)
    >>> w.toStr(4)  # 448251.0 5411932.0001
    >>> w.toStr(sep=', ')  # 448251, 5411932

### toStr2(self, prec=3, fmt=`'``[%s]``'`, sep=`'``,` `'`, radius=False) |
Return a string representation of this WM coordinate. Parameters: `prec` - Optional number of decimals, unstripped (`int`). `fmt` - Optional, enclosing backets format (`str`). `sep` - Optional separator between name:value pairs (`str`). `radius` - Optionally, include radius (`bool` or `scalar`). Returns: This WM as "[x:meter, y:meter]" (`str`) plus ", radius:meter]" if `radius` is `True` or `scalar`. Raises: `WebMercatorError` - Invalid `radius`. Overrides: named._Named.toStr2

Property Details

### radius An immutable property (`Read Only`). Get Method: radius(self) - Get the earth radius (`meter`). Set Method: immutable(inst, value) - Throws an `AttributeError`, always.

### x An immutable property (`Read Only`). Get Method: x(self) - Get the easting (`meter`). Set Method: immutable(inst, value) - Throws an `AttributeError`, always.

### y An immutable property (`Read Only`). Get Method: y(self) - Get the northing (`meter`). Set Method: immutable(inst, value) - Throws an `AttributeError`, always.