Skip to content

gbelouze/mgrs

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This is a fork of the mgrs library by Howard Butler, for my use case only. Please use and credit the original package.

mgrs: Converting to and from MGRS and Decimal Degrees

GeoTrans provides C code for converting to and from MGRS, but well, it's C code :). This is a simple ctypes wrapper around two of the MGRS-related functions in GeoTrans.

This library has an internal copy of some of the files from GeoTrans 2.4.2.

ChangeLog

2.0

  • API change ⚠️

1.5.0

  • Docstrings added
  • API change ⚠️

1.4.3

  • Wheels
  • black, flake8, and isort linters

1.4.2

  • GitHub Action builders needed to be changed to push release

1.4.1

  • Fix install requirements #34

1.4.0

  • Alias and deprecate RTreeError #33

1.3.9

  • MGRS now requires packaging library #31
  • Fix wheel imports of shared libs

1.3.8

  • UTF-8 encoding for all strings.
  • Fix #29 implicit tuple on return of UTMToMGRS

1.3.7

  • automated building of osx, linux and win64 wheels
  • Migrate from TravisCI => GitHub Actions
  • Warnings cleanup
  • flake8 validation

1.3.6

  • required positional argument for wheel.425tags.get_platform() hobuinc#24

1.3.4

  • Truncate, don't round results hobuinc#15
  • Apply license

1.3.3

1.3.2

  • Better Windows support
  • Bug fix for 3 digit longitudes

1.3.1

  • Python 3.x support
  • Allow user to override precision in UTMToMGRS

Usage

In a nutshell:

>>> import mgrs

>>> latitude = 42.0
>>> longitude = -93.0

>>> m = mgrs.MGRS()
>>> c = m.toMGRS(latitude, longitude)
>>> c
'15TWG0000049776'

>>> d = m.toLatLon(c)
>>> d
(41.999997975127997, -93.000000000000014)

>>> y = '321942.29N'
>>> yd = m.dmstodd(y)
32.328414

>>> d, m, s = m.ddtodms(32.328414)
>>> d, m, s
(32.0, 19.0, 42.290400)

You can also control the precision of the MGRS grid with the MGRSPrecision arguments in .toMGRS(). Other than that, there isn't too much to it.

About

Python MGRS library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 88.3%
  • Python 10.8%
  • Other 0.9%