Package pygeodesy :: Module mgrs |
[frames] | no frames]

# Module mgrs

Military Grid Reference System (MGRS/NATO) class Mgrs and functions parseMGRS and toMgrs.

Pure Python implementation of MGRS / UTM conversion functions using an ellipsoidal earth model, transcribed from JavaScript originals by (C) Chris Veness 2014-2016 published under the same MIT Licence**, see MGRS and Module mgrs.

The MGRS/NATO grid references provides geocoordinate references covering the entire globe, based on UTM projections.

MGRS references comprise a grid zone designation, a 100 km square identification, and an easting and northing (in metres).

Depending on requirements, some parts of the reference may be omitted (implied), and easting/northing may be given to varying resolution.

See also United States National Grid and Military Grid Reference System.

Version: 18.09.23

Classes
| Mgrs Military Grid Reference System (MGRS/NATO) references, with method to convert to UTM coordinates.

Functions
parseMGRS(strMGRS, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, Mgrs=<class 'pygeodesy.mgrs.Mgrs'>, name=`'````'`) Parse a string representing a MGRS grid reference, consisting of zoneBand, grid, easting and northing. |
toMgrs(utm, Mgrs=<class 'pygeodesy.mgrs.Mgrs'>, name=`'````'`) Convert a UTM coordinate to an MGRS grid reference. |

Function Details

### parseMGRS(strMGRS, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran`...`, Mgrs=<class 'pygeodesy.mgrs.Mgrs'>, name=`'````'`) |
Parse a string representing a MGRS grid reference, consisting of zoneBand, grid, easting and northing. Parameters: `strMGRS` - MGRS grid reference (string). `datum` - Optional datum to use (Datum). `Mgrs` - Optional Mgrs (sub-)class to use for the MGRS grid reference (Mgrs) or None. `name` - Optional Mgrs name (string). Returns: The MGRS grid reference (Mgrs) or 4-tuple (zone, ENdigraph, easting, northing) if Mgrs is None. Raises: `ValueError` - Invalid strMGRS. Example:
    >>> m = parseMGRS('31U DQ 48251 11932')
    >>> str(m)  # 31U DQ 48251 11932
    >>> m = parseMGRS('31UDQ4825111932')
    >>> repr(m)  # [Z:31U, G:DQ, E:48251, N:11932]

### toMgrs(utm, Mgrs=<class 'pygeodesy.mgrs.Mgrs'>, name=`'````'`) |
Convert a UTM coordinate to an MGRS grid reference. Parameters: `utm` - A UTM coordinate (Utm). `Mgrs` - Optional Mgrs class to use for the MGRS grid reference (Mgrs). `name` - Optional Mgrs name (string). Returns: The MGRS grid reference (Mgrs). Raises: `TypeError` - If utm is not Utm. `ValueError` - Invalid utm. Example:
    >>> u = Utm(31, 'N', 448251, 5411932)
    >>> m = u.toMgrs()  # 31U DQ 48251 11932