Metadata-Version: 2.1
Name: bng-latlon
Version: 1.0.3
Summary: Converts british national grid (OSBG36) to lat lon (WGS84) and vice versa.
Home-page: https://github.com/fmalina/blocl-bnglatlon
Author: Hannah Fry, F. Malina
Author-email: hi@blocl.com
License: MIT License
Project-URL: Homepage, https://blocl.uk
Project-URL: Funding, https://unilexicon.com/fm/pay.html
Project-URL: Source, https://github.com/fmalina/blocl-bnglatlon
Keywords: GPS,OSGB
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering :: GIS
License-File: LICENSE

BNG ⇄ LatLon
------------
Converts british national grid eastings and northings (OSBG36) to latitude and longitude (WGS84) and vice versa as used by https://blocl.uk

Originally authored by `Hannah Fry`_.

**NEW!** importable, installable, PEP8 styled, pure python, doctested, with optional numba compiler support for 10x speed

Documentation
-------------
Package includes:

- `bng_to_latlon.py`_ originally published as "`Converting British National Grid to Latitude and Longitude II`_"
- `latlon_to_bng.py`_ originally "`Converting Latitude and Longitude to British National grid`_"

The mathematical theory used here is set out in "`A guide to coordinate systems in Great Britain`_" by Ordnance Survey.

Installation
------------

Get the latest stable release from PyPi:

::

    pip install bng_latlon

optional but recommend is numba compiler

::

    pip install numba


Usage
-----

::

    >>> from bng_latlon import OSGB36toWGS84
    >>> OSGB36toWGS84(538890, 177320)
    (51.477795, -0.001402)
    ...
    >>> from bng_latlon import WGS84toOSGB36
    >>> WGS84toOSGB36(51.4778, -0.0014)
    (538890.1053, 177320.4965)


.. _bng_to_latlon.py: https://github.com/fmalina/bng_latlon/blob/master/bng_latlon/bng_to_latlon.py
.. _latlon_to_bng.py: https://github.com/fmalina/bng_latlon/blob/master/bng_latlon/latlon_to_bng.py
.. _`Hannah Fry`: http://www.hannahfry.co.uk/
.. _`Converting British National Grid to Latitude and Longitude II`: https://web.archive.org/web/20170211043005/http://www.hannahfry.co.uk/blog/2012/02/01/converting-british-national-grid-to-latitude-and-longitude-ii
.. _`Converting Latitude and Longitude to British National grid`: https://web.archive.org/web/20170212042531/http://www.hannahfry.co.uk/blog/2012/02/01/converting-latitude-and-longitude-to-british-national-grid
.. _`A guide to coordinate systems in Great Britain`: https://www.ordnancesurvey.co.uk/documents/resources/guide-coordinate-systems-great-britain.pdf


