Package pygeodesy :: Module points :: Class LatLon_ |
[frames] | no frames]

# Class LatLon_

    object --+
             |
            LatLon_

Known Subclasses:
  - clipy._LLi_

Low-overhead `LatLon` class for Numpy2LatLon and Tuple2LatLon.

Instance Methods
PointsIter(self, points, loop=0, dedup=False) Return a points iterator. |
__eq__(self, other) |
__init__(self, lat, lon, name='', height=0, datum=None) Creat a new, mininal, low-overhead LatLon_ instance, without height and datum. |
__ne__(self, other) |
__repr__(self) repr(x) |
__str__(self) str(x) |
classof(self, *args, **kwds) Instantiate this very class. |
copy(self, deep=False) Make a shallow or deep copy of this instance. |
dup(self, **items) Duplicate this instance, replacing some items. |
heightStr(self, prec=-2) Return a string for the height `height`. |
intermediateTo(self, other, fraction, height=None, wrap=False) Locate the point at a given fraction between (or along) this and an other point. |
isequalTo(self, other, eps=None) Compare this point with an other point, ignoring height. |
others(self, *other, **name_other_up) Refined class comparison. |
points(self, points, closed=False, base=None) DEPRECATED, use method `points2`. |
points2(self, points, closed=False, base=None) Check a path or polygon represented by points. |
to2ab(self) DEPRECATED, use property philam. |
toNvector(self, h=None, Nvector=<class 'pygeodesy.nvectorBase.NvectorBase'>, **Nvector_kwds) Convert this point to `n-vector` (normal to the earth's surface) components, including height. |
toRepr(self, **kwds) This LatLon_ as a string "class(<degrees>, ...)". |
toStr(self, form=`'``d``'`, prec=6, sep=', ', **s_D_M_S_kwds) This LatLon_ as a string "<degrees>, <degrees>". |
toStr2(self, **kwds) DEPRECATED, used method toRepr. |
Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__setattr__`, `__sizeof__`, `__subclasshook__`

Class Variables
| _ATTRS_ = `None` hash(x)

Properties
| latlon Get the lat- and longitude in `degrees` (LatLon2Tuple`(lat, lon)`).
| latlonheight Get the lat-, longitude and height (LatLon3Tuple`(lat, lon, height)`).
| philam Get the lat- and longitude in `radians` (PhiLam2Tuple`(phi, lam)`).
| philamheight Get the lat-, longitude in `radians` and height (PhiLam3Tuple`(phi, lam, height)`).
Inherited from `object`: `__class__`

Method Details

### PointsIter (self, points, loop=0, dedup=False) |
Return a points iterator. Arguments: `points` - The path or polygon points (`LatLon`[]) `loop` - Number of loop-back points (non-negative `int`). `dedup` - Skip duplicate points (`bool`). Returns: A new `PointsIter` iterator. Raises: `PointsError` - Insufficient number of `points`.

### __init__ (self, lat, lon, name='', height=0, datum=None) (Constructor) |
Creat a new, mininal, low-overhead LatLon_ instance, without height and datum. Arguments: `lat` - Latitude (`degrees`). `lon` - Longitude (`degrees`). `name` - Optional name (`str`). `height` - Optional height (`float` or `int`). `datum` - Optional datum (Datum, Ellipsoid, Ellipsoid2, a_f2Tuple or scalar radius) or `None`. Raises: `TypeError` - Invalid `datum`. Overrides: object.__init__ Note: The lat- and longitude are taken as-given, un-clipped and un-validated .

### __repr__ (self) (Representation operator) |
repr(x) Overrides: object.__repr__ (inherited documentation)

### __str__ (self) (Informal representation operator) |
str(x) Overrides: object.__str__ (inherited documentation)

### classof (self, *args, **kwds) |
Instantiate this very class. Arguments: `args` - Optional, positional arguments. `kwds` - Optional, keyword arguments. Returns: New instance (`self.__class__`).

### copy (self, deep=False) |
Make a shallow or deep copy of this instance. Arguments: `deep` - If `True` make a deep, otherwise a shallow copy (`bool`). Returns: The copy (`This` (sub-)class).

### dup (self, **items) |
Duplicate this instance, replacing some items. Arguments: `items` - Attributes to be changed (`any`). Returns: The duplicate (`This` (sub-)class). Raises: `AttributeError` - Some `items` invalid.

### heightStr (self, prec=-2) |
Return a string for the height `height`. Arguments: `prec` - Optional number of decimals, unstripped (`int`). See Also: Function pygeodesy.hstr.

### intermediateTo (self, other, fraction, height=None, wrap=False) |
Locate the point at a given fraction between (or along) this and an other point. Arguments: `other` - The other point (`LatLon`). `fraction` - Fraction between both points (`float`, 0.0 for this and 1.0 for the other point). `height` - Optional height (`meter`), overriding the intermediate height. `wrap` - Wrap and unroll longitudes (`bool`). Returns: Intermediate point (this `LatLon`). Raises: `TypeError` - Incompatible `other` `type`.

### isequalTo (self, other, eps=None) |
Compare this point with an other point, ignoring height. Arguments: `other` - The other point (`LatLon`). `eps` - Tolerance for equality (`degrees`). Returns: `True` if both points are identical, ignoring height, `False` otherwise. Raises: `UnitError` - Invalid `eps`.

### others (self, *other, **name_other_up) |
Refined class comparison. Arguments: `other` - The other instance (any `type`). `name_other_up` - Overriding `name=other` and `up=1` keyword arguments. Returns: The `other` if compatible. Raises: `TypeError` - Incompatible `other` `type`.

### points (self, points, closed=False, base=None) |
DEPRECATED, use method `points2`. Decorators: `@deprecated_method`

### points2 (self, points, closed=False, base=None) |
Check a path or polygon represented by points. Arguments: `points` - The path or polygon points (`LatLon`[]) `closed` - Optionally, consider the polygon closed, ignoring any duplicate or closing final `points` (`bool`). `base` - Optionally, check all `points` against this base class, if `None` don't check. Returns: A Points2Tuple`(number, points)` with the number of points and the points `list` or `tuple`. Raises: `PointsError` - Insufficient number of `points`. `TypeError` - Some `points` are not `base`.

### to2ab (self) |
DEPRECATED, use property philam. Decorators: `@deprecated_method`

### toNvector (self, h=None, Nvector=<class 'pygeodesy.nvectorBase.NvectorBase'>, **Nvector_kwds) |
Convert this point to `n-vector` (normal to the earth's surface) components, including height. Arguments: `h` - Optional height, overriding this point's height (`meter`). `Nvector` - Optional class to return the `n-vector` components (`Nvector`) or `None`. `Nvector_kwds` - Optional, additional `Nvector` keyword arguments, ignored if `Nvector is None`. Returns: The `n-vector` components `Nvector` or if `Nvector` is `None`, a Vector4Tuple`(x, y, z, h)`. Raises: `TypeError` - Invalid `Nvector` or `Nvector_kwds` argument.

### toRepr (self, **kwds) |
This LatLon_ as a string "class(<degrees>, ...)". Arguments: `kwds` - Optional, keyword arguments. Returns: Class instance (`str`).

### toStr (self, form=`'``d``'`, prec=6, sep=', ', **s_D_M_S_kwds) |
This LatLon_ as a string "<degrees>, <degrees>". Arguments: `form` - Format specifier (`str` or F_D, F_DM, F_DMS, F_DEG, F_MIN, F_SEC, F_D60, F__E, F__F, F__G, F_RAD, F_D_, F_DM_, F_DMS_, F_DEG_, F_MIN_, F_SEC_, F_D60_, F__E_, F__F_, F__G_, F_RAD_, F_D__, F_DM__, F_DMS__, F_DEG__, F_MIN__, F_SEC__, F_D60__, F__E__, F__F__, F__G__ or F_RAD__) `prec` - Number of decimal digits (0..9 or `None` for default). Trailing zero decimals are stripped for `prec` values of 1 and above, but kept for negative `prec`. `sep` - Separator between degrees, minutes, seconds and suffix (`str`). `s_D_M_S` - Optional keyword arguments `s_D=str`, `s_M=str` and/or `s_S=str` to override the degrees, minutes respectively seconds symbol, defaults S_DEG, S_MIN respectively S_SEC. Returns: This instance in the specified `form` (`str`). See Also: Function pygeodesy.degDMS for `form` and `s_D_M_S`.

### toStr2 (self, **kwds) |
DEPRECATED, used method toRepr. Decorators: `@deprecated_method`

Property Details

### latlon Get the lat- and longitude in `degrees` (LatLon2Tuple`(lat, lon)`). Get method: latlon(self) - Get the lat- and longitude in `degrees` (LatLon2Tuple`(lat, lon)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### latlonheight Get the lat-, longitude and height (LatLon3Tuple`(lat, lon, height)`). Get method: latlonheight(self) - Get the lat-, longitude and height (LatLon3Tuple`(lat, lon, height)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### philam Get the lat- and longitude in `radians` (PhiLam2Tuple`(phi, lam)`). Get method: philam(self) - Get the lat- and longitude in `radians` (PhiLam2Tuple`(phi, lam)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.

### philamheight Get the lat-, longitude in `radians` and height (PhiLam3Tuple`(phi, lam, height)`). Get method: philamheight(self) - Get the lat-, longitude in `radians` and height (PhiLam3Tuple`(phi, lam, height)`). Set method: _fset_error(inst, val) - Throws an `AttributeError`, always. Delete Method: _fdel(inst) - Zap the cached/memoized `property` value.