Metadata-Version: 1.0
Name: Shapely
Version: 1.2b4
Summary: Planar geometries, predicates, and operations
Home-page: http://trac.gispython.org/lab/wiki/Shapely
Author: Sean Gillies
Author-email: sean.gillies@gmail.com
License: BSD
Description: 
        Shapely
        =======
        
        .. image:: http://gispython.org/images/shapely-med.png
        :width: 640
        :height: 320
        
        Shapely is a BSD-licensed Python package for manipulation and analysis of
        planar geometries. It is not concerned with data formats or coordinate
        systems. It is based on the widely deployed GEOS_ (the engine of PostGIS_) and
        JTS_ (from which GEOS is ported) libraries. This C dependency is traded for the
        ability to analyze geometries with blazing speed.
        
        In a nutshell: Shapely lets you do PostGIS-ish stuff outside the context of a
        database using idiomatic Python. For more details, see:
        
        * Shapely wiki_
        * Shapely manual_
        * Shapely `example apps`_
        
        
        Dependencies
        ------------
        
        Shapely 1.2 depends on:
        
        * Python >=2.5,<3
        * libgeos_c >=3.1 (3.0 and below have not been tested, YMMV)
        
        
        Installation
        ------------
        
        Windows users should use the executable installer, which contains the required
        GEOS DLL. Other users should acquire libgeos_c by any means, make sure that it
        is on the system library path, and install from the Python package index::
        
        $ pip install Shapely
        
        or from a source distribution with the setup script::
        
        $ python setup.py install
        
        
        Usage
        -----
        
        Here is the canonical example of building an approximately circular patch by
        buffering a point::
        
        >>> from shapely.geometry import Point
        >>> patch = Point(0.0, 0.0).buffer(10.0)
        >>> patch
        <shapely.geometry.polygon.Polygon object at 0x...>
        >>> patch.area
        313.65484905459385
        
        See the manual_ for comprehensive usage snippets and the dissolve.py and
        intersect.py `example apps`_.
        
        
        Numpy integration
        -----------------
        
        All linear geometries, such as the rings of a polygon, provide the Numpy array
        interface::
        
        >>> from numpy import asarray
        >>> ag = asarray(patch.exterior)
        >>> ag
        array([[  1.00000000e+01,   0.00000000e+00],
        [  9.95184727e+00,  -9.80171403e-01],
        [  9.80785280e+00,  -1.95090322e+00],
        ...
        [  1.00000000e+01,   0.00000000e+00]])
        
        That yields a numpy array of [x, y] arrays. This is not exactly what one wants
        for plotting shapes with Matplotlib, so Shapely 1.2 adds a `xy` geometry
        property for getting separate arrays of coordinate x and y values::
        
        >>> x, y = patch.exterior.xy
        >>> ax = asarray(x)
        >>> ax
        array([  1.00000000e+01,   9.95184727e+00,   9.80785280e+00,  ...])
        
        Numpy arrays can also be adapted to Shapely linestrings::
        
        >>> from shapely.geometry import asLineString
        >>> asLineString(ag).length
        62.806623139095073
        >>> asLineString(ag).wkt
        'LINESTRING (10.0000000000000000 0.0000000000000000, ...)'
        
        
        Testing
        -------
        
        Shapely uses a Zope-stye suite of unittests and doctests, excercised like::
        
        $ python setup.py test
        
        
        Support
        -------
        
        For current information about this project, see the wiki_.
        
        If you have questions, please consider joining our community list:
        
        http://trac.gispython.org/projects/PCL/wiki/CommunityList
        
        
        Credits
        -------
        
        Shapely is written by:
        
        * Sean Gillies
        * Aron Bierbaum
        * Kai Lautaportti
        
        Patches contributed by:
        
        * Howard Butler
        * Fr |eaigue| d |eaigue| ric Junod
        * Eric Lemoine
        * Jonathan Tartley
        * Kristian Thy
        * Oliver Tonnhofer
        
        Additional help from:
        
        * Justin Bronn (GeoDjango) for ctypes inspiration
        * Martin Davis (JTS)
        * Sandro Santilli, Mateusz Loskot, Paul Ramsey, et al (GEOS Project)
        
        Major portions of this work were supported by a grant (for Pleiades_) from the
        U.S. National Endowment for the Humanities (http://www.neh.gov).
        
        
        .. _JTS: http://www.vividsolutions.com/jts/jtshome.htm
        .. _PostGIS: http://postgis.org
        .. _GEOS: http://trac.osgeo.org/geos/
        .. _example apps: http://trac.gispython.org/lab/wiki/Examples
        .. _wiki: http://trac.gispython.org/lab/wiki/Shapely
        .. _manual: http://gispython.org/shapely/manual.html
        .. |eaigue| unicode:: U+00E9
        :trim:
        .. _Pleiades: http://pleiades.stoa.org
        
Keywords: geometry topology gis
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: GIS
