Module utmups

Parse a string representing a UTM or UPS coordinate, consisting of "zone[band] hemisphere/pole easting northing".

Arguments:

• strUTMUPS - A UTM or UPS coordinate (str).
• datum - Optional datum to use (Datum).
• Utm - Optional class to return the UTM coordinate (Utm) or None.
• Ups - Optional class to return the UPS coordinate (Ups) or None.
• name - Optional instance name (str).

Returns:

The UTM or UPS instance (Utm or Ups) or a UtmUps5Tuple(zone, hemipole, easting, northing, band) if Utm respectively Ups or both are None. The hemipole is 'N'|'S', the UTM hemisphere or UPS pole, the UPS projection top/center.

Raises:

• UTMUPSError - Invalid strUTMUPS.

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

Arguments:

• 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).
• falsed - False both easting and northing (bool).
• Utm - Optional class to return the UTM coordinate (Utm) or None.
• Ups - Optional 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).
• cmoff - DEPRECATED, use falsed. Offset longitude from zone's central meridian, for UTM only (bool).

Returns:

The UTM or UPS coordinate (Utm respectively Ups) or a UtmUps8Tuple(zone, hemipole, easting, northing, band, datum, gamma, scale) if Utm respectively Ups is None or cmoff is False.

Raises:

• RangeError - If lat outside the valid UTM or UPS bands or if lat or lon outside the valid range and pygeodesy.rangerrors set to True.
• TypeError - If latlon is not ellipsoidal or lon value is missing of datum is invalid.
• UTMUPSError - UTM or UPS validation failed.
• ValueError - Invalid lat or lon.

Class-like function to create a UTM/UPS coordinate.

Arguments:

• zone - The UTM zone with/-out longitudinal Band or UPS zone 0 or "00" with/-out polar Band (str or int).
• hemipole - UTM hemisphere or UPS top/center of projection (str, 'N[orth]' or 'S[outh]').
• easting - Easting, see falsed (meter).
• northing - Northing, see falsed (meter).
• band - Optional, UTM latitudinal 'C'|'D'|..|'W'|'X' or UPS polar Band letter 'A'|'B'|'Y'|'Z' Band letter (str).
• datum - Optional, the coordinate's datum (Datum).
• falsed - Both easting and northing are falsed (bool).
• name - Optional name (str).

Returns:

New UTM or UPS instance (Utm or Ups).

Raises:

• TypeError - Invalid datum.
• UTMUPSError - UTM or UPS validation failed.

Check a UTM or UPS coordinate.

Arguments:

• coord - The UTM or UPS coordinate (Utm, Etm, Ups or 5+Tuple).
• falsed - 5+Tuple easting and northing are falsed (bool), ignored otherwise.
• MGRS - Increase easting and northing ranges (bool).
• Error - Optional error to raise, overriding the default (UTMUPSError).

Returns:

None if validation passed.

Raises:

• Error - Validation failed.

Check a UTM or UPS coordinate.

Arguments:

• coord - The UTM or UPS coordinate (Utm, Ups or 5+Tuple).
• falsed - 5+Tuple easting and northing are falsed (bool).
• ok - Result to return if validation passed (ok).

Returns:

ok if validation passed, the UTMUPSError otherwise.

Return the UTM/UPS zone number, Band letter, hemisphere/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).
• cmoff - Offset longitude from the zone's central meridian, for UTM only (bool).
• name - Optional name (str).

Returns:

A UtmUpsLatLon5Tuple(zone, band, hemipole, lat, lon) where hemipole is 'N'|'S', the UTM hemisphere or UPS pole, the UPS projection top/center.

Raises:

• RangeError - If lat outside the valid UTM or UPS bands or if lat or lon outside the valid range and pygeodesy.rangerrors set to True.
• ValueError - Invalid lat or lon.