shapely 1.2__tar.gz → 1.2b1__tar.gz

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

@@ -1,46 +1,5 @@
 All tickets are children of http://trac.gispython.org/lab/ticket.
 
-1.2 (2010-05-27)
-----------------
-- Final release.
-
-1.2rc2 (2010-05-26)
--------------------
-- Add examples and tests to MANIFEST.in.
-- Release candidate 2.
-
-1.2rc1 (2010-05-25)
--------------------
-- Release candidate.
-
-1.2b7 (2010-04-22)
-------------------
-- Memory leak associated with new empty geometry state fixed.
-
-1.2b6 (2010-04-13)
-------------------
-- Broken GeometryCollection fixed.
-
-1.2b5 (2010-04-09)
-------------------
-- Objects can be constructed from others of the same type, thereby making
-  copies. Collections can be constructed from sequences of objects, also making
-  copies.
-- Collections are now iterators over their component objects.
-- New code for manual figures, using the descartes package.
-
-1.2b4 (2010-03-19)
-------------------
-- Adds support for the "sunos5" platform.
-
-1.2b3 (2010-02-28)
-------------------
-- Only provide simplification implementations for GEOS C API >= 1.5.
-
-1.2b2 (2010-02-19)
-------------------
-- Fix cascaded_union bug introduced in 1.2b1 (#212).
-
 1.2b1 (2010-02-18)
 ------------------
 - Update the README. Remove cruft from setup.py. Add some version 1.2 metadata

Shapely-1.2b1/CREDITS.txt

@@ -0,0 +1,9 @@
+Sean Gillies (Pleiades)
+Howard Butler (Hobu, Inc.)
+Kai Lautaportti (Hexagon IT)
+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).

{Shapely-1.2 → Shapely-1.2b1}/MANIFEST.in

@@ -1,5 +1,3 @@
 exclude *.txt
 recursive-exclude manual *
 include CHANGES.txt CREDITS.txt LICENSE.txt README.txt
-recursive-include shapely/tests *.py *.txt
-recursive-include shapely/examples *.py

{Shapely-1.2 → Shapely-1.2b1}/PKG-INFO

@@ -1,24 +1,28 @@
 Metadata-Version: 1.0
 Name: Shapely
-Version: 1.2
-Summary: Geometric objects, predicates, and operations
+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: =======
+Description: 
         Shapely
         =======
         
-        .. image:: http://farm3.static.flickr.com/2738/4511827859_b5822043b7_o_d.png
-        :width: 800
+        .. 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 geometric objects. It is not concerned with data formats or coordinate
-        systems.  It is based on the widely deployed GEOS_ (the engine of PostGIS_) and
+        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 execute with blazing speed.
+        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:
@@ -27,6 +31,7 @@ Description: =======
         * Shapely manual_
         * Shapely `example apps`_
         
+        
         Dependencies
         ------------
         
@@ -35,6 +40,7 @@ Description: =======
         * Python >=2.5,<3
         * libgeos_c >=3.1 (3.0 and below have not been tested, YMMV)
         
+        
         Installation
         ------------
         
@@ -48,6 +54,7 @@ Description: =======
         
         $ python setup.py install
         
+        
         Usage
         -----
         
@@ -64,19 +71,12 @@ Description: =======
         See the manual_ for comprehensive usage snippets and the dissolve.py and
         intersect.py `example apps`_.
         
-        Integration
-        -----------
-        
-        Shapely does not read or write data files, but it can serialize and deserialize
-        using several well known formats and protocols. The shapely.wkb and shapely.wkt
-        modules provide dumpers and loaders inspired by Python's pickle module.::
         
-        >>> from shapely.wkt import dumps, loads
-        >>> dumps(loads('POINT (0 0)'))
-        'POINT (0.0000000000000000 0.0000000000000000)'
+        Numpy integration
+        -----------------
         
-        All linear objects, such as the rings of a polygon (like ``patch`` above),
-        provide the Numpy array interface.::
+        All linear geometries, such as the rings of a polygon, provide the Numpy array
+        interface::
         
         >>> from numpy import asarray
         >>> ag = asarray(patch.exterior)
@@ -87,9 +87,9 @@ Description: =======
         ...
         [  1.00000000e+01,   0.00000000e+00]])
         
-        That yields a numpy array of [x, y] arrays. This is not always exactly what one
-        wants for plotting shapes with Matplotlib, so Shapely 1.2 adds a `xy` property
-        for getting separate arrays of coordinate x and y values.::
+        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)
@@ -104,16 +104,14 @@ Description: =======
         >>> asLineString(ag).wkt
         'LINESTRING (10.0000000000000000 0.0000000000000000, ...)'
         
+        
         Testing
         -------
         
-        Shapely uses a Zope-stye suite of unittests and doctests, excercised via
-        setup.py.::
+        Shapely uses a Zope-stye suite of unittests and doctests, excercised like::
         
         $ python setup.py test
         
-        Nosetests won't run the tests properly; Zope doctest suites are not currently
-        supported well by nose.
         
         Support
         -------
@@ -124,47 +122,42 @@ Description: =======
         
         http://trac.gispython.org/projects/PCL/wiki/CommunityList
         
+        
         Credits
         -------
         
         Shapely is written by:
         
-        * Sean Gillies
+        * Sean Gillies (Pleiades)
         * Aron Bierbaum
-        * Kai Lautaportti
-        
-        Patches contributed by:
+        * Howard Butler (Hobu, Inc.)
+        * Kai Lautaportti (Hexagon IT)
+        * Fr |eaigue| d |eaigue| ric Junod (Camptocamp SA)
+        * Eric Lemoine (Camptocamp SA)
         
-        * Howard Butler
-        * Fr |eaigue| d |eaigue| ric Junod
-        * Eric Lemoine
-        * Jonathan Tartley
-        * Kristian Thy
-        * Oliver Tonnhofer
-        
-        Additional help from:
+        with additional help from:
         
         * Justin Bronn (GeoDjango) for ctypes inspiration
         * Martin Davis (JTS)
-        * Jaakko Salli for the Windows distributions
         * 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/docs/1.2
+        .. _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 :: 5 - Production/Stable
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License

{Shapely-1.2 → Shapely-1.2b1}/README.txt

@@ -1,16 +1,20 @@
-=======
+
 Shapely
 =======
 
-.. image:: http://farm3.static.flickr.com/2738/4511827859_b5822043b7_o_d.png
-   :width: 800
+.. 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 geometric objects. It is not concerned with data formats or coordinate
-systems.  It is based on the widely deployed GEOS_ (the engine of PostGIS_) and
+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 execute with blazing speed.
+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:
@@ -19,6 +23,7 @@ database using idiomatic Python. For more details, see:
 * Shapely manual_
 * Shapely `example apps`_
 
+
 Dependencies
 ------------
 
@@ -27,6 +32,7 @@ Shapely 1.2 depends on:
 * Python >=2.5,<3
 * libgeos_c >=3.1 (3.0 and below have not been tested, YMMV)
 
+
 Installation
 ------------
 
@@ -40,6 +46,7 @@ or from a source distribution with the setup script::
 
   $ python setup.py install
 
+
 Usage
 -----
 
@@ -56,19 +63,12 @@ buffering a point::
 See the manual_ for comprehensive usage snippets and the dissolve.py and
 intersect.py `example apps`_.
 
-Integration 
------------
 
-Shapely does not read or write data files, but it can serialize and deserialize
-using several well known formats and protocols. The shapely.wkb and shapely.wkt
-modules provide dumpers and loaders inspired by Python's pickle module.::
+Numpy integration
+-----------------
 
-  >>> from shapely.wkt import dumps, loads
-  >>> dumps(loads('POINT (0 0)'))
-  'POINT (0.0000000000000000 0.0000000000000000)'
-
-All linear objects, such as the rings of a polygon (like ``patch`` above),
-provide the Numpy array interface.::
+All linear geometries, such as the rings of a polygon, provide the Numpy array
+interface::
 
   >>> from numpy import asarray
   >>> ag = asarray(patch.exterior)
@@ -79,9 +79,9 @@ provide the Numpy array interface.::
          ...
          [  1.00000000e+01,   0.00000000e+00]])
 
-That yields a numpy array of [x, y] arrays. This is not always exactly what one
-wants for plotting shapes with Matplotlib, so Shapely 1.2 adds a `xy` property
-for getting separate arrays of coordinate x and y values.::
+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)
@@ -96,16 +96,14 @@ Numpy arrays can also be adapted to Shapely linestrings::
   >>> asLineString(ag).wkt
   'LINESTRING (10.0000000000000000 0.0000000000000000, ...)'
 
+
 Testing
 -------
 
-Shapely uses a Zope-stye suite of unittests and doctests, excercised via
-setup.py.::
+Shapely uses a Zope-stye suite of unittests and doctests, excercised like::
 
   $ python setup.py test
 
-Nosetests won't run the tests properly; Zope doctest suites are not currently
-supported well by nose.
 
 Support
 -------
@@ -116,40 +114,35 @@ 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
+* Sean Gillies (Pleiades)
 * Aron Bierbaum
-* Kai Lautaportti
+* Howard Butler (Hobu, Inc.)
+* Kai Lautaportti (Hexagon IT)
+* Fr |eaigue| d |eaigue| ric Junod (Camptocamp SA)
+* Eric Lemoine (Camptocamp SA)
 
-Patches contributed by:
-
-* Howard Butler
-* Fr |eaigue| d |eaigue| ric Junod
-* Eric Lemoine
-* Jonathan Tartley
-* Kristian Thy
-* Oliver Tonnhofer
-
-Additional help from:
+with additional help from:
 
 * Justin Bronn (GeoDjango) for ctypes inspiration
 * Martin Davis (JTS)
-* Jaakko Salli for the Windows distributions
 * 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/docs/1.2
+.. _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.2 → Shapely-1.2b1}/Shapely.egg-info/PKG-INFO

@@ -1,24 +1,28 @@
 Metadata-Version: 1.0
 Name: Shapely
-Version: 1.2
-Summary: Geometric objects, predicates, and operations
+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: =======
+Description: 
         Shapely
         =======
         
-        .. image:: http://farm3.static.flickr.com/2738/4511827859_b5822043b7_o_d.png
-        :width: 800
+        .. 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 geometric objects. It is not concerned with data formats or coordinate
-        systems.  It is based on the widely deployed GEOS_ (the engine of PostGIS_) and
+        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 execute with blazing speed.
+        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:
@@ -27,6 +31,7 @@ Description: =======
         * Shapely manual_
         * Shapely `example apps`_
         
+        
         Dependencies
         ------------
         
@@ -35,6 +40,7 @@ Description: =======
         * Python >=2.5,<3
         * libgeos_c >=3.1 (3.0 and below have not been tested, YMMV)
         
+        
         Installation
         ------------
         
@@ -48,6 +54,7 @@ Description: =======
         
         $ python setup.py install
         
+        
         Usage
         -----
         
@@ -64,19 +71,12 @@ Description: =======
         See the manual_ for comprehensive usage snippets and the dissolve.py and
         intersect.py `example apps`_.
         
-        Integration
-        -----------
-        
-        Shapely does not read or write data files, but it can serialize and deserialize
-        using several well known formats and protocols. The shapely.wkb and shapely.wkt
-        modules provide dumpers and loaders inspired by Python's pickle module.::
         
-        >>> from shapely.wkt import dumps, loads
-        >>> dumps(loads('POINT (0 0)'))
-        'POINT (0.0000000000000000 0.0000000000000000)'
+        Numpy integration
+        -----------------
         
-        All linear objects, such as the rings of a polygon (like ``patch`` above),
-        provide the Numpy array interface.::
+        All linear geometries, such as the rings of a polygon, provide the Numpy array
+        interface::
         
         >>> from numpy import asarray
         >>> ag = asarray(patch.exterior)
@@ -87,9 +87,9 @@ Description: =======
         ...
         [  1.00000000e+01,   0.00000000e+00]])
         
-        That yields a numpy array of [x, y] arrays. This is not always exactly what one
-        wants for plotting shapes with Matplotlib, so Shapely 1.2 adds a `xy` property
-        for getting separate arrays of coordinate x and y values.::
+        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)
@@ -104,16 +104,14 @@ Description: =======
         >>> asLineString(ag).wkt
         'LINESTRING (10.0000000000000000 0.0000000000000000, ...)'
         
+        
         Testing
         -------
         
-        Shapely uses a Zope-stye suite of unittests and doctests, excercised via
-        setup.py.::
+        Shapely uses a Zope-stye suite of unittests and doctests, excercised like::
         
         $ python setup.py test
         
-        Nosetests won't run the tests properly; Zope doctest suites are not currently
-        supported well by nose.
         
         Support
         -------
@@ -124,47 +122,42 @@ Description: =======
         
         http://trac.gispython.org/projects/PCL/wiki/CommunityList
         
+        
         Credits
         -------
         
         Shapely is written by:
         
-        * Sean Gillies
+        * Sean Gillies (Pleiades)
         * Aron Bierbaum
-        * Kai Lautaportti
-        
-        Patches contributed by:
+        * Howard Butler (Hobu, Inc.)
+        * Kai Lautaportti (Hexagon IT)
+        * Fr |eaigue| d |eaigue| ric Junod (Camptocamp SA)
+        * Eric Lemoine (Camptocamp SA)
         
-        * Howard Butler
-        * Fr |eaigue| d |eaigue| ric Junod
-        * Eric Lemoine
-        * Jonathan Tartley
-        * Kristian Thy
-        * Oliver Tonnhofer
-        
-        Additional help from:
+        with additional help from:
         
         * Justin Bronn (GeoDjango) for ctypes inspiration
         * Martin Davis (JTS)
-        * Jaakko Salli for the Windows distributions
         * 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/docs/1.2
+        .. _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 :: 5 - Production/Stable
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License

{Shapely-1.2 → Shapely-1.2b1}/Shapely.egg-info/SOURCES.txt

@@ -51,15 +51,12 @@ shapely/tests/Predicates.txt
 shapely/tests/__init__.py
 shapely/tests/attribute-chains.txt
 shapely/tests/binascii_hex.txt
-shapely/tests/cascaded_union.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_collection.py
 shapely/tests/test_doctests.py
-shapely/tests/test_emptiness.py
 shapely/tests/test_equality.py
 shapely/tests/test_geomseq.py
 shapely/tests/test_prepared.py

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')
+