Package pygeodesy :: Module ltp :: Class ChLVe |
[frames] | no frames]

# Class ChLVe

              object --+
                       |
                   _ChLV --+
                           |
      object --+           |
               |           |
    named._Named --+       |
                   |       |
    named._NamedBase --+   |
                       |   |
          LocalCartesian --+
                           |
                       ChLVa --+
                               |
                              ChLVe

Conversion between WGS84 geodetic and Swiss projection coordinates using the Ellipsoidal approximate formulas, pp 10-11.

See Also: Older references.

Instance Methods
__init__(self, name=`'``Bern``'`) New `ChLVe` Ellipsoidal approximate WGS84-Swiss converter, centered at Bern, Ch. |
forward(self, latlonh, lon=None, height=0, M=None, name='') Convert WGS84 geodetic to Swiss projection coordinates. |
reverse(self, enh_, n=None, h_=0, M=None, name='') Convert I{Swiss} projection to WGS84 geodetic coordinates. |
Inherited from `LocalCartesian`: `__eq__`, `reset`, `toStr` Inherited from `named._NamedBase`: `__repr__`, `__str__`, `others`, `toRepr` 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
Inherited from `LocalCartesian`: `M`, `datum`, `ecef`, `height0`, `lat0`, `latlonheight0`, `lon0` Inherited from `named._Named`: `classname`, `classnaming`, `iteration`, `name`, `named`, `named2`, `named3`, `named4` Inherited from `object`: `__class__`

Method Details

### __init__ (self, name=`'``Bern``'`) (Constructor) |
New `ChLVe` Ellipsoidal approximate WGS84-Swiss converter, centered at Bern, Ch. Arguments: `name` - Optional name (`str`), overriding `Bern.name`. Overrides: object.__init__

### forward (self, latlonh, lon=None, height=0, M=None, name='') |
Convert WGS84 geodetic to Swiss projection coordinates. Arguments: `latlonh` - Either a `LatLon`, Ltp or `scalar` (geodetic) latitude (`degrees`). `lon` - Optional, `scalar` (geodetic) longitude for `scalar` `latlonh` (`degrees`). `height` - Optional, height, vertically above (or below) the surface of the ellipsoid (`meter`) for `scalar` `latlonh`. `M` - Optionally, return the concatenated rotation EcefMatrix, iff avaialble (`bool`). `name` - Optional name (`str`). Returns: A ChLV9Tuple`(Y, X, h_, lat, lon, height, ltp, ecef, M)` with unfalsed Swiss Y, X, h_ coordinates and height, the given geodetic `(lat`, `lon`, `height`, this `ChLV*` and `ecef` (Ecef9Tuple) at Bern, Ch and rotation matrix `M`. Raises: `LocalError` - If `latlonh` not `scalar`, `LatLon` or Ltp, invalid or if `lon` not `scalar` for `scalar` `latlonh` or invalid or if `height` invalid. Overrides: LocalCartesian.forward (inherited documentation)

### reverse (self, enh_, n=None, h_=0, M=None, name='') |
    Convert I{Swiss} projection to WGS84 geodetic coordinates.

    @arg enh_: A Swiss projection (L{ChLV9Tuple}) or the C{scalar}, I{falsed Swiss
               E_LV95} or I{y_LV03} coordinate (C{meter}).
    @kwarg n: I{Falsed Swiss N_LV85} or I{x_LV03} coordinate for C{scalar}
              B{C{enh_}} and B{C{h_}} (C{meter}).
    @kwarg h_: I{Swiss h'} height for C{scalar} B{C{enh_}} and B{C{n}} (C{meter}).
    @kwarg M: Optionally, return the I{concatenated} rotation L{EcefMatrix}, I{iff
              avaialble} (C{bool}).
    @kwarg name: Optional name (C{str}).

    @return: A L{ChLV9Tuple}C{(Y, X, h_, lat, lon, height, ltp, ecef, M)} with
             the I{unfalsed Swiss (Y, X, h_)} coordinates and height, I{geodetic}
             C{(lat, lon, height)}, this C{ChLV*} and C{ecef} (L{Ecef9Tuple})
             I{at Bern, Ch} and with rotation matrix C{B{M}=None}.

    @note: The returned C{ltp} is this C{ChLV}, C{ChLVa} or C{ChLVe} instance.

    @raise LocalError: Invalid B{C{enh_}} or B{C{n}} or B{C{h_}} not C{scalar}
                       for C{scalar} B{C{enh_}.
Arguments: `xyz` - A local (XyzLocal, Enu, Ned, Aer, Local9Tuple) or local `x` coordinate (`scalar`). `y` - Local `y` coordinate for `scalar` `xyz` and `z` (`meter`). `z` - Local `z` coordinate for `scalar` `xyz` and `y` (`meter`). `M` - Optionally, return the concatenated rotation EcefMatrix, iff avaialble (`bool`). `name` - Optional name (`str`). Returns: An Local9Tuple`(x, y, z, lat, lon, height, ltp, ecef, M)` with local `x`, `y`, `z`, geodetic `lat`, `lon`, `height`, this `ltp`, an `ecef` (Ecef9Tuple) with the geocentric `x`, `y`, `z` (and geodetic `lat`, `lon`, `height`) and the concatenated rotation matrix `M` (EcefMatrix) if requested. Raises: `LocalError` - Invalid `xyz` or `scalar` `x` or `y` and/or `z` not `scalar` for `scalar` `xyz`. Overrides: LocalCartesian.reverse (inherited documentation)