shapely 1.0.15__tar.gz → 1.2b1__tar.gz

{Shapely-1.0.15 → Shapely-1.2b1}/CHANGES.txt

@@ -1,15 +1,28 @@
 All tickets are children of http://trac.gispython.org/lab/ticket.
 
-1.0.14 (2009-10-05)
--------------------
+1.2b1 (2010-02-18)
+------------------
+- Update the README. Remove cruft from setup.py. Add some version 1.2 metadata
+  regarding required Python version (>=2.5,<3) and external dependency
+  (libgeos_c >= 3.1).
+
+1.2a6 (2010-02-09)
+------------------
+- Add accessor for separate arrays of X and Y values (#210).
+
+TODO: fill gap here
+
+1.2a1 (2010-01-20)
+------------------
 - Proper prototyping of WKB writer, and avoidance of errors on 64-bit systems
   (#191).
-
-1.0.13 (2009-09-29)
--------------------
 - Prototype libgeos_c functions in a way that lets py2exe apps import shapely
   (#189).
-  
+
+=========================
+1.2 Branched (2009-09-19)
+=========================
+
 1.0.12 (2009-04-09)
 -------------------
 - Fix for references held by topology and predicate descriptors.
@@ -65,3 +78,23 @@ All tickets are children of http://trac.gispython.org/lab/ticket.
 1.0.2 (2008-02-26)
 ------------------
 - Fix loss of dimensionality in polygon rings (#155).
+
+1.0.1 (2008-02-08)
+------------------
+- Allow chaining expressions involving coordinate sequences and geometry parts
+  (#151).
+- Protect against abnormal use of coordinate accessors (#152).
+- Coordinate sequences now implement the numpy array protocol (#153).
+
+1.0 (2008-01-18)
+----------------
+- Final release.
+
+1.0 RC2 (2008-01-16)
+--------------------
+- Added temporary solution for #149.
+
+1.0 RC1 (2008-01-14)
+--------------------
+- First release candidate
+

{Shapely-1.0.15 → Shapely-1.2b1}/CREDITS.txt

@@ -5,5 +5,5 @@ Frédéric Junod (Camptocamp SA)
 Eric Lemoine (Camptocamp SA)
 Justin Bronn (GeoDjango) for ctypes inspiration
 
-Some of this work was supported by a grant from the U.S. National Endowment 
-for the Humanities (http://www.neh.gov).
+Some of this work was supported by a grant from the U.S. National Endowment for
+the Humanities (http://www.neh.gov).

Shapely-1.2b1/MANIFEST.in

@@ -0,0 +1,3 @@
+exclude *.txt
+recursive-exclude manual *
+include CHANGES.txt CREDITS.txt LICENSE.txt README.txt

Shapely-1.2b1/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 1.0
+Name: Shapely
+Version: 1.2b1
+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://trac.gispython.org/lab/raw-attachment/wiki/Examples/dissolve.png
+        :width: 400
+        :height: 400
+        
+        .. image:: http://trac.gispython.org/lab/raw-attachment/wiki/Examples/intersect.png
+        :width: 400
+        :height: 400
+        
+        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 (Pleiades)
+        * Aron Bierbaum
+        * Howard Butler (Hobu, Inc.)
+        * Kai Lautaportti (Hexagon IT)
+        * Fr |eaigue| d |eaigue| ric Junod (Camptocamp SA)
+        * Eric Lemoine (Camptocamp SA)
+        
+        with 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/projects/PCL/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

Shapely-1.2b1/README.txt

@@ -0,0 +1,148 @@
+
+Shapely
+=======
+
+.. image:: http://trac.gispython.org/lab/raw-attachment/wiki/Examples/dissolve.png
+   :width: 400
+   :height: 400
+
+.. image:: http://trac.gispython.org/lab/raw-attachment/wiki/Examples/intersect.png
+   :width: 400
+   :height: 400
+
+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 (Pleiades)
+* Aron Bierbaum
+* Howard Butler (Hobu, Inc.)
+* Kai Lautaportti (Hexagon IT)
+* Fr |eaigue| d |eaigue| ric Junod (Camptocamp SA)
+* Eric Lemoine (Camptocamp SA)
+
+with 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/projects/PCL/wiki/Shapely
+.. _manual: http://gispython.org/shapely/manual.html
+.. |eaigue| unicode:: U+00E9
+   :trim:
+.. _Pleiades: http://pleiades.stoa.org

Shapely-1.2b1/Shapely.egg-info/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 1.0
+Name: Shapely
+Version: 1.2b1
+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://trac.gispython.org/lab/raw-attachment/wiki/Examples/dissolve.png
+        :width: 400
+        :height: 400
+        
+        .. image:: http://trac.gispython.org/lab/raw-attachment/wiki/Examples/intersect.png
+        :width: 400
+        :height: 400
+        
+        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 (Pleiades)
+        * Aron Bierbaum
+        * Howard Butler (Hobu, Inc.)
+        * Kai Lautaportti (Hexagon IT)
+        * Fr |eaigue| d |eaigue| ric Junod (Camptocamp SA)
+        * Eric Lemoine (Camptocamp SA)
+        
+        with 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/projects/PCL/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

Shapely-1.2b1/Shapely.egg-info/SOURCES.txt

@@ -0,0 +1,65 @@
+CHANGES.txt
+CREDITS.txt
+LICENSE.txt
+MANIFEST.in
+README.txt
+setup.cfg
+setup.py
+Shapely.egg-info/PKG-INFO
+Shapely.egg-info/SOURCES.txt
+Shapely.egg-info/dependency_links.txt
+Shapely.egg-info/top_level.txt
+examples/dissolve.py
+examples/intersect.py
+shapely/__init__.py
+shapely/coords.py
+shapely/ctypes_declarations.py
+shapely/geoms.py
+shapely/geos.py
+shapely/impl.py
+shapely/iterops.py
+shapely/linref.py
+shapely/ops.py
+shapely/predicates.py
+shapely/prepared.py
+shapely/topology.py
+shapely/wkb.py
+shapely/wkt.py
+shapely/geometry/__init__.py
+shapely/geometry/base.py
+shapely/geometry/collection.py
+shapely/geometry/geo.py
+shapely/geometry/linestring.py
+shapely/geometry/multilinestring.py
+shapely/geometry/multipoint.py
+shapely/geometry/multipolygon.py
+shapely/geometry/point.py
+shapely/geometry/polygon.py
+shapely/geometry/proxy.py
+shapely/tests/Array.txt
+shapely/tests/GeoInterface.txt
+shapely/tests/IterOps.txt
+shapely/tests/LineString.txt
+shapely/tests/MultiLineString.txt
+shapely/tests/MultiPoint.txt
+shapely/tests/MultiPolygon.txt
+shapely/tests/Operations.txt
+shapely/tests/Persist.txt
+shapely/tests/Point.txt
+shapely/tests/Polygon.txt
+shapely/tests/Predicates.txt
+shapely/tests/__init__.py
+shapely/tests/attribute-chains.txt
+shapely/tests/binascii_hex.txt
+shapely/tests/dimensions.txt
+shapely/tests/invalid_intersection.txt
+shapely/tests/linear-referencing.txt
+shapely/tests/linemerge.txt
+shapely/tests/polygonize.txt
+shapely/tests/test_doctests.py
+shapely/tests/test_equality.py
+shapely/tests/test_geomseq.py
+shapely/tests/test_prepared.py
+shapely/tests/test_xy.py
+shapely/tests/threading_test.py
+shapely/tests/wkt_locale.txt

Shapely-1.2b1/examples/dissolve.py

@@ -0,0 +1,52 @@
+# dissolve.py
+#
+# Demonstrate how Shapely can be used to build up a collection of patches by 
+# dissolving circular regions and how Shapely supports plotting of the results.
+
+from functools import partial
+import random
+
+import pylab
+
+from shapely.geometry import Point
+from shapely.ops import cascaded_union
+
+# Use a partial function to make 100 points uniformly distributed in a 40x40 
+# box centered on 0,0.
+r = partial(random.uniform, -20.0, 20.0)
+points = [Point(r(), r()) for i in range(100)]
+
+# Buffer the points, producing 100 polygon spots
+spots = [p.buffer(2.5) for p in points]
+
+# Perform a cascaded union of the polygon spots, dissolving them into a 
+# collection of polygon patches
+patches = cascaded_union(spots)
+
+# Illustrate the results using matplotlib's pylab interface
+pylab.figure(num=None, figsize=(4, 4), dpi=180)
+
+for patch in patches.geoms:
+    assert patch.geom_type in ['Polygon']
+    assert patch.is_valid
+
+    # Fill and outline each patch
+    x, y = patch.exterior.xy
+    pylab.fill(x, y, color='#cccccc', aa=True) 
+    pylab.plot(x, y, color='#666666', aa=True, lw=1.0)
+
+    # Do the same for the holes of the patch
+    for hole in patch.interiors:
+        x, y = hole.xy
+        pylab.fill(x, y, color='#ffffff', aa=True) 
+        pylab.plot(x, y, color='#999999', aa=True, lw=1.0)
+
+# Plot the original points
+pylab.plot([p.x for p in points], [p.y for p in points], 'b,', alpha=0.75)
+
+# Write the number of patches and the total patch area to the figure
+pylab.text(-25, 25, 
+    "Patches: %d, total area: %.2f" % (len(patches.geoms), patches.area))
+
+pylab.savefig('dissolve.png')
+