Metadata-Version: 1.1
Name: epsg_ident
Version: 0.1.0
Summary: Quickly get the EPSG code from a .prj file or WKT
Home-page: https://github.com/cmollet/epsg_ident
Author: Cory Mollet
Author-email: cory@corymollet.com
License: ISCL
Description: epsg\_ident
        ===========
        
        Travis CI stuff goes here
        
        Overview
        --------
        
        ``epsg_ident`` is a command-line utility and Python module for quickly
        identifying the `EPSG Registry Code <http://www.epsg-registry.org/>`__
        from a ``.prj`` file typically associated with `ESRI
        Shapefiles <https://en.wikipedia.org/wiki/Shapefile>`__. It ships with a
        SQlite3 database containing mappings of `Well-known
        Text <https://en.wikipedia.org/wiki/Well-known_text>`__ strings to EPSG
        codes, the bulk of which was manually sourced and cleaned from `an ESRI
        website <https://developers.arcgis.com/javascript/jshelp/pcs.html>`__.
        It's not complete, however, and in the event you test it against a WKT
        string not in the database it will search the
        `prj2epsg.org <http://prj2epsg.org>`__ API. If the API returns an exact
        match, that code is returned and saved to the SQLite database. Handling
        several partial matches is currently planned, but not yet implemented.
        
        Background
        ----------
        
        Think of projections as character encoding for spatial data. Spatial
        data lacking information about the coordinate system on which it has
        been projected is all but useless, just as if you had text data in an
        unknown encoding.
        
        Command-Line usage
        ------------------
        
        .. code:: bash
        
            $ epsg_ident seattle_land_use.prj
            2285
        
        Python module usage
        -------------------
        
        .. code:: python
        
            >>> from epsg_ident import EpsgIdent
        
            >>> # Read .prj file from the filesystem
            >>> ident = EpsgIdent()
            >>> ident.read_prj_from_file('seattle_land_use.prj')
            >>> ident.get_epsg()
            2285
        
            >>> # Paste in Well-Known Text string directly
            >>> ident = EpsgIdent(prj="""PROJCS["NAD_1983_StatePlane_Washington_North_FIPS_4601_Feet",GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Conformal_Conic"],PARAMETER["False_Easting",1640416.666666667],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",-120.8333333333333],PARAMETER["Standard_Parallel_1",47.5],PARAMETER["Standard_Parallel_2",48.73333333333333],PARAMETER["Latitude_Of_Origin",47.0],UNIT["Foot_US",0.3048006096012192]]""")
            >>> ident.get_epsg()
            2285
        
Keywords: epsg,gis,shapefile
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Utilities
