Metadata-Version: 1.1
Name: convertbng
Version: 0.1.24
Summary: Fast lon, lat to BNG conversion
Home-page: https://github.com/urschrei/convertbng
Author: Stephan Hügel
Author-email: urschrei@gmail.com
License: MIT License
Download-URL: https://github.com/urschrei/convertbng/tarball/v0.1.24
Description: ===============================================
        Fast lon, lat to BNG conversion, and vice versa
        ===============================================
        |  Uses a Rust 1.x binary to perform fast longitude, latitude to `BNG <https://en.wikipedia.org/wiki/Ordnance_Survey_National_Grid>`_ conversion.
        
        |  This module exposes three methods: 
        
        |  ``util.convertbng()`` – pass a lon, lat. Returns a tuple of Eastings, Northings
        |  ``util.convertbng_list()`` – pass lists (or Numpy arrays) of lons, lats.
        |  ``util.convertlonlat_list()`` – pass lists (or Numpy arrays) of Eastings, Northings.
        
        The first two methods return Easting, Northing tuples (in a list in the case of the latter), while the third method returns a list of lon, lat tuples. 
        
        Installation
        ============
        |  Installation as a binary wheel using pip, for OS X: 
        |  ``pip install convertbng`` 
        
        |  Binary wheels aren't yet available for Linux or Windows, but installation directly from Github works: 
        |  ``pip install git+git://github.com/urschrei/convertbng.git`` 
        
        Usage
        =====
        
        .. code-block:: python
        
            from convertbng.util import convertbng, convertbng_list, convertlonlat_list
        
            # convert a single value
            res = convertbng(lon, lat)
        
            # convert lists of longitude and latitude values to BNG Eastings and Northings
            lons = [lon1, lon2, lon3]
            lats = [lat1, lat2, lat3]
            res_list = convertbng_list(lons, lats)
        
            # convert lists of BNG Eastings and Northings to longitude, latitude
            eastings = [easting1, easting2, easting3]
            northings = [northing1, northing2, northing3]
            res_list_en = convertlonlat_list(eastings, northings)
        
            # assumes numpy imported as np
            lons_np = np.array(lons)
            lats_np = np.array(lats)
            res_list_np = convertbng_list(lons_np, lats_np)
        
        Testing
        =======
        Run ``nosetests`` (requires `Nose <http://nose.readthedocs.org/en/latest/>`_)
        
Keywords: Geo,BNG
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
