Package pygeodesy :: Module etm :: Class Etm
[frames] | no frames]

Class Etm

   object --+                
            |                
 named._Named --+            
                |            
 named._NamedBase --+        
                    |        
utmupsBase.UtmUpsBase --+    
                        |    
                  utm.Utm --+
                            |
                           Etm

Exact Transverse Mercator (ETM) coordinate, a sub-class of Utm, a Universal Transverse Mercator (UTM) coordinate using the ExactTransverseMercator projection for highest accuracy.


Note: Conversion of Etm coordinates to and from (geodetic) lat- and longitude is 3-4 times slower than Utm.

See Also: Karney's Detailed Description.

Instance Methods
 
__init__(self, zone, hemisphere, easting, northing, band='', datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., falsed=True, convergence=None, scale=None, name='')
New Etm coordinate.
 
parseETM(self, strETM)
Parse a string to a ETM coordinate.
 
toLatLon(self, LatLon=None, unfalse=True, **unused)
Convert this ETM coordinate to an (ellipsoidal) geodetic point.
 
toUtm(self)
Coopy this ETM to a UTM coordinate.

Inherited from utm.Utm: __eq__, __repr__, __str__, copy, parseUTM, toEtm, toMgrs, toStr, toStr2, toUps

Inherited from utmupsBase.UtmUpsBase: to2en, toEpsg

Inherited from named._NamedBase: others

Inherited from named._Named: __copy__, classof

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __setattr__, __sizeof__, __subclasshook__

Properties
  exactTM
Get the ETM projection (ExactTransverseMercator).

Inherited from utm.Utm: band, falsed2, pole, zone

Inherited from utmupsBase.UtmUpsBase: convergence, datum, easting, falsed, hemisphere, northing, scale, scale0

Inherited from named._Named: classname, classnaming, name, named, named2

Inherited from object: __class__

Method Details

__init__(self, zone, hemisphere, easting, northing, band='', datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., falsed=True, convergence=None, scale=None, name='')
(Constructor)

 

New Etm coordinate.

Parameters:
  • zone - Longitudinal UTM zone (int, 1..60) or zone with/-out (latitudinal) Band letter (str, '01C'..'60X').
  • hemisphere - Northern or southern hemisphere (str, 'N[orth]' or 'S[outh]').
  • easting - Easting, see falsed (meter).
  • northing - Northing, see falsed (meter).
  • band - Optional, (latitudinal) band (str, 'C'..'X').
  • datum - Optional, this coordinate's datum (Datum).
  • falsed - Both easting and northing are falsed (bool).
  • convergence - Optional meridian convergence, bearing off grid North, clockwise from true North (degrees) or None.
  • scale - Optional grid scale factor (scalar) or None.
  • name - Optional name (str).
Raises:
Overrides: object.__init__

Example:

>>> import pygeodesy
>>> u = pygeodesy.Utm(31, 'N', 448251, 5411932)

parseETM(self, strETM)

 

Parse a string to a ETM coordinate.

Returns:
The coordinate (Etm).

See Also: Function parseETM5 in this module etm.

toLatLon(self, LatLon=None, unfalse=True, **unused)

 

Convert this ETM coordinate to an (ellipsoidal) geodetic point.

Parameters:
  • LatLon - Optional, ellipsoidal (sub-)class to return the point (LatLon) or None.
  • unfalse - Unfalse easting and northing if falsed (bool).
Returns:
This ETM coordinate as (LatLon) or a LatLonDatum5Tuple(lat, lon, datum, convergence, scale) if LatLon is None.
Raises:
  • EllipticError - No convergence.
  • TypeError - If LatLon is not ellipsoidal.
Overrides: utm.Utm.toLatLon

Example:

>>> u = Utm(31, 'N', 448251.795, 5411932.678)
>>> from pygeodesy import ellipsoidalVincenty as eV
>>> ll = u.toLatLon(eV.LatLon)  # 48°51′29.52″N, 002°17′40.20″E

toUtm(self)

 

Coopy this ETM to a UTM coordinate.

Parameters:
  • zone - New UTM zone (int).
  • eps - Optional convergence limit, EPS or above (float), see method Utm.toLatLon.
  • falsed - False both easting and northing (bool).
Returns:
The UTM coordinate (Utm).
Overrides: utm.Utm.toUtm

Property Details

exactTM

Get the ETM projection (ExactTransverseMercator).

Get Method:
exactTM(self) - Get the ETM projection (ExactTransverseMercator).
Set Method:
exactTM(self, exactTM) - Set the ETM projection (ExactTransverseMercator).