pygeodesy.ltp.ChLVe

Conversion between WGS84 geodetic and Swiss projection coordinates using the Ellipsoidal approximate formulas, pp 10-11 and Bolliger, J. pp 148-151 (also GGGS).

Note: Methods ChLVe.forward and ChLVe.reverse have an additional keyword argument gamma=False to approximate the meridian convergence. If gamma=True a 2-tuple (t, gamma) is returned with t the usual result (ChLV9Tuple) and gamma, the meridian convergence (decimal degrees). To convert gamma to grades or gons, use function pygeodesy.degrees2grades.

See Also: Older references.

init (self, name=`'Bern'`)
(Constructor)

New Approximate WGS84-Swiss ChLVe converter, centered at Bern, Ch.

Arguments:

name - Optional name=Bern.name (str).

Raises:

LocalError - If latlonh0 not LatLon, LatLon4Tuple, Ltp, LocalCartesian or Ecef9Tuple or latlonh0, lon0, height0 or lon00 invalid.
TypeError - Invalid ecef or not EcefKarney.

Overrides: object.__init__

forward (self, latlonh, lon=None, height=0, M=None, gamma=False, **name)

Convert WGS84 geodetic to Swiss projection coordinates. Must be overloaded.

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 and lon.
M - If True, return the concatenated rotation EcefMatrix iff available for ChLV only, None otherwise (bool).
name - Optional name=NN (str).

Returns:

A ChLV9Tuple

(Y, X, h_, lat, lon, height, 
          ltp, ecef, M)

with the unfalsed Swiss Y, X coordinates, Swiss h_ height, the given geodetic lat, lon and height, this ChLV* instance and ecef (Ecef9Tuple) at Bern, Ch and rotation matrix M. The returned ltp is this ChLV, ChLVa or ChLVe instance.

Raises:

LocalError - Invalid or non-scalar latlonh, lon or height.

Overrides: LocalCartesian.forward

(inherited documentation)

reverse (self, enh_, n=None, h_=0, M=None, gamma=False, **name)

Convert Swiss projection to WGS84 geodetic coordinates.

Arguments:

enh_ - A Swiss projection (ChLV9Tuple) or the scalar, falsed Swiss E_LV95 or y_LV03 easting (meter).
n - Falsed Swiss N_LV85 or x_LV03 northing for scalar enh_ and h_ (meter).
h_ - Swiss h' height for scalar enh_ and n (meter).
M - If True, return the concatenated rotation EcefMatrix iff available for ChLV only, None otherwise (bool).
name - Optional name=NN (str).

Returns:

A ChLV9Tuple

(Y, X, h_, lat, lon, height, 
          ltp, ecef, M)

Raises:

LocalError - Invalid or non-scalar enh_, n or h_.

Overrides: LocalCartesian.reverse

(inherited documentation)

Class ChLVe

__init__ (self, name='Bern') (Constructor)

forward (self, latlonh, lon=None, height=0, M=None, gamma=False, **name)

reverse (self, enh_, n=None, h_=0, M=None, gamma=False, **name)

init (self, name=`'Bern'`)
(Constructor)