Module ups

Parse a string representing a UPS coordinate, consisting of "[zone][band] pole easting northing" where zone is pseudo zone "00"|"0"|"" and band is 'A'|'B'|'Y'|'Z'|''.

Arguments:

• strUPS - A UPS coordinate (str).
• datum - Optional datum to use (Datum).
• Ups - Optional class to return the UPS coordinate (Ups) or None.
• falsed - If True, both easting and northing are falsed (bool).
• name - Optional Ups name=NN (str).

Returns:

The UPS coordinate (Ups) or if Ups is None, a UtmUps5Tuple(zone, hemipole, easting, northing, band). The hemipole is the 'N'|'S' pole, the UPS projection top/center.

Raises:

• UPSError - Invalid strUPS.

Convert a lat-/longitude point to a UPS coordinate.

Arguments:

• latlon - Latitude (degrees) or an (ellipsoidal) geodetic LatLon point.
• lon - Optional longitude (degrees) or None if latlon is a LatLon.
• datum - Optional datum for this UPS coordinate, overriding latlon's datum (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple).
• Ups - Optional class to return the UPS coordinate (Ups) or None.
• pole - Optional top/center of (stereographic) projection (str, 'N[orth]' or 'S[outh]').
• falsed - If True, false both easting and northing (bool).
• strict - Restrict lat to UPS ranges (bool).
• name - Optional Ups name=NN (str).

Returns:

The UPS coordinate (Ups) or if Ups is None, a UtmUps8Tuple(zone, hemipole, easting, northing, band, datum, gamma, scale) where hemipole is the 'N'|'S' pole, the UPS projection top/center.

Raises:

• RangeError - If strict and lat outside the valid UPS bands or if lat or lon outside the valid range and rangerrors is True.
• TypeError - If latlon is not ellipsoidal or if datum is invalid.
• ValueError - If lon value is missing or if latlon is invalid.

Return the UTM/UPS zone number, polar Band letter, pole and clipped lat- and longitude for a given location.

Arguments:

• lat - Latitude in degrees (scalar or str).
• lon - Longitude in degrees (scalar or str).
• strict - Restrict lat to UPS ranges (bool).
• name - Optional Ups name=NN (str).

Returns:

A UtmUpsLatLon5Tuple(zone, band, hemipole, lat, lon) where hemipole is the 'N'|'S' pole, the UPS projection top/center and lon [-180..180).

Raises:

• RangeError - If strict is True and lat within the UTM but not the UPS range or if lat or lon outside the valid range and rangerrors is True.
• ValueError - Invalid lat or lon.