toUtmUps8(latlon,
lon=None,
datum=None,
Utm=<class 'pygeodesy.utm.Utm'>,
Ups=<class 'pygeodesy.ups.Ups'>,
pole='
' ,
name='
' )
|
|
Convert a lat-/longitude point to a UTM or UPS coordinate.
- Parameters:
latlon - Latitude (degrees ) or an (ellipsoidal) geodetic
LatLon point.
lon - Optional longitude (degrees ) or None .
datum - Optional datum to use this UTM coordinate, overriding
latlon's datum (Datum ).
Utm - Optional (sub-)class to return the UTM coordinate (Utm) or
None .
Ups - Optional (sub-)class to return the UPS coordinate (Ups) or
None .
pole - Optional top/center of UPS (stereographic) projection
(str , 'N[orth]' or
'S[outh]' ).
name - Optional name (str ).
- Returns:
- The UTM or UPS coordinate (Utm respectively Ups) or an
8-tuple (
zone, hemisphere/pole, easting, northing, Band,
datum, convergence, scale ) if Utm respectively
Ups is None or cmoff is
False as (int, 'N'|'S', meter, meter, str,
degrees, scalar ) where zone is
1..60 for UTM or 0 for UPS and
Band is "" or
'C'|'D'..'W'|'X' for UTM or
'A'|'B'|'Y'|'Z' for UPS.
- Raises:
RangeError - If lat outside the valid UTM or UPS bands or if lat
or lon outside the valid range and rangerrrors set to
True .
TypeError - If latlon is not ellipsoidal or lon value is missing.
UTMUPSError - UTM or UPS validation failed.
ValueError - Invalid lat or lon.
|