tiebenn.tools.utm module

tiebenn.tools.utm.from_latlon(latitude, longitude, force_zone_number=None, force_zone_letter=None)[source]

This function converts Latitude and Longitude to UTM coordinate

Parameters:

  • latitude (float or NumPy array) – Latitude between 80 deg S and 84 deg N, e.g. (-80.0 to 84.0)

  • longitude (float or NumPy array) – Longitude between 180 deg W and 180 deg E, e.g. (-180.0 to 180.0).

  • force_zone_number (int) – Zone number is represented by global map numbers of an UTM zone numbers map. You may force conversion to be included within one UTM zone number. For more information see utmzones

  • force_zone_letter (str) –

    You may force conversion to be included within one UTM zone letter. For more information see utmzones

Returns:

  • easting (float or NumPy array) – Easting value of UTM coordinates

  • northing (float or NumPy array) – Northing value of UTM coordinates

  • zone_number (int) – Zone number is represented by global map numbers of a UTM zone numbers map. More information see utmzones

  • zone_letter (str) – Zone letter is represented by a string value. UTM zone designators can be accessed here

tiebenn.tools.utm.to_latlon(easting, northing, zone_number, zone_letter=None, northern=None, strict=True)[source]

This function converts UTM coordinates to Latitude and Longitude

Parameters:

  • easting (int or NumPy array) – Easting value of UTM coordinates

  • northing (int or NumPy array) – Northing value of UTM coordinates

  • zone_number (int) –

    Zone number is represented with global map numbers of a UTM zone numbers map. For more information see utmzones

  • zone_letter (str) – Zone letter can be represented as string values. UTM zone designators can be seen in this reference

  • northern (bool) – You can set True or False to set this parameter. Default is None

  • strict (bool) – Raise an OutOfRangeError if outside of bounds

Returns:

  • latitude (float or NumPy array) – Latitude between 80 deg S and 84 deg N, e.g. (-80.0 to 84.0)

  • longitude (float or NumPy array) – Longitude between 180 deg W and 180 deg E, e.g. (-180.0 to 180.0).