Module utm
Universal Transverse Mercator (UTM) class Utm and functions parseUTM and
toUtm.
Pure Python implementation of UTM / WGS-84 conversion functions using
an ellipsoidal earth model, transcribed from JavaScript originals by
(C) Chris Veness 2011-2016 published under the same MIT Licence**,
see UTM and Module utm.
The UTM system is a 2-dimensional cartesian coordinate system
providing locations on the surface of the earth.
UTM is a set of 60 transverse Mercator projections, normally based on
the WGS-84 ellipsoid. Within each zone, coordinates are represented as
eastings and northings, measured in metres.
This method based on Karney 'Transverse
Mercator with an accuracy of a few nanometers', 2011 (building on
Krüger 'Konforme Abbildung des Erdellipsoids in der Ebene',
1912).
Other references Seidel 'Die Mathematik der Gauß-Krueger-Abbildung', 2006, Transverse Mercator Projection, and Universal Transverse Mercator coordinate system.
|
Utm
Universal Transverse Mercator (UTM) coordinate.
|
|
parseUTM(strUTM,
datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran... ,
Utm=<class 'pygeodesy.utm.Utm'>)
Parse a string representing a UTM coordinate, consisting of zone,
hemisphere, easting and northing. |
|
|
|
toUtm(latlon,
lon=None,
datum=None,
Utm=<class 'pygeodesy.utm.Utm'>)
Convert a lat-/longitude point to a UTM coordinate. |
|
|
parseUTM(strUTM,
datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran... ,
Utm=<class 'pygeodesy.utm.Utm'>)
|
|
Parse a string representing a UTM coordinate, consisting of zone,
hemisphere, easting and northing.
- Parameters:
strUTM - A UTM coordinate (string).
datum - Optional datum to use (Datum).
Utm - Optional Utm class to use for the UTM coordinate (Utm) or
None.
- Returns:
- The UTM coordinate (Utm) or 4-tuple (zone, hemisphere, easting,
northing) if Utm is None.
- Raises:
ValueError - Invalid strUTM.
Example:
>>> u = parseUTM('31 N 448251 5411932')
>>> u.toStr2()
>>> u = parseUTM('31 N 448251.8 5411932.7')
>>> u.toStr()
|
toUtm(latlon,
lon=None,
datum=None,
Utm=<class 'pygeodesy.utm.Utm'>)
|
|
Convert a lat-/longitude point to a UTM coordinate.
- Parameters:
latlon - Latitude (degrees) or an (ellipsoidal) geodetic LatLon
point.
lon - Optional longitude (degrees or None).
datum - Optional datum for this UTM coordinate, overriding latlon's datum
(Datum).
Utm - Optional Utm class to usefor the UTM coordinate (Utm).
- Returns:
- The UTM coordinate (Utm).
- Raises:
TypeError - If latlon is not ellipsoidal.
ValueError - If lon value is missing, if latlon is not scalar or
latlon is outside the valid UTM bands.
Note:
Implements Karney’s method, using 6-th order Krüger series, giving
results accurate to 5 nm for distances up to 3900 km from the
central meridian.
Example:
>>> p = LatLon(48.8582, 2.2945)
>>> u = toUtm(p)
>>> p = LatLon(13.4125, 103.8667)
>>> u = toUtm(p)
|