shapely 1.0b3__tar.gz → 1.0rc1__tar.gz

Shapely-1.0rc1/CREDITS.txt

@@ -0,0 +1,10 @@
+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
+Artem Pavlenko (Mapnik) for help with GEOS DLLs
+
+Some of this work was supported by a grant from the U.S. National Endowment for
+the Humanities (http://www.neh.gov).

Shapely-1.0rc1/HISTORY.txt

@@ -0,0 +1,5 @@
+1.0 RC1: 14 January 2008
+------------------------
+
+- First release candidate
+

{Shapely-1.0b3 → Shapely-1.0rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.0
 Name: Shapely
-Version: 1.0b3
+Version: 1.0rc1
 Summary: Geospatial geometries, predicates, and operations
 Home-page: http://trac.gispython.org/projects/PCL/wiki/Shapely
 Author: Sean Gillies
@@ -9,8 +9,8 @@ License: BSD
 Description: Shapely
         =======
         
-        Shapely is a Python package for programming with geospatial geometries. It is
-        based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about
+        Shapely is a Python package for programming with 2D geospatial geometries. It
+        is based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about
         coordinate and reference systems. Projection responsibility is left to specific
         applications. For more information, see:
         
@@ -20,14 +20,16 @@ Description: Shapely
         Shapely requires Python 2.4+. (I've also begun to port it to Python 3.0:
         http://zcologia.com/news/564/shapely-for-python-3-0/.)
         
+        
         Dependencies
         ------------
         
-        * libgeos_c (2.2.3, also reported to work with 3.0)
+        * libgeos_c (2.2.3 or 3.0.0+)
         * Python ctypes_ (standard in Python 2.5+)
         
         .. _ctypes: http://pypi.python.org/pypi/ctypes/
         
+        
         Installation
         ------------
         
@@ -39,26 +41,29 @@ Description: Shapely
         
         $ sudo python setup.py install
         
-        or by using the development buildout, which also provides libgeos_c::
+        or by using the development buildout on Linux, which also provides libgeos_c::
         
         $ svn co http://svn.gispython.org/svn/gispy/buildout/shapely.buildout/trunk shapely.buildout
         $ cd shapely.buildout
         $ python bootstrap.py
         $ ./bin/buildout
         
+        
         Usage
         -----
         
-        Buffer a point::
+        To buffer a point::
         
         >>> from shapely.geometry import Point
         >>> point = Point(-106.0, 40.0) # longitude, latitude
         >>> point.buffer(10.0)
         <shapely.geometry.polygon.Polygon object at ...>
         
-        See Operations.txt and Predicates.txt under tests/ for more examples of the
-        spatial operations and predicates provided by Shapely. Also see Point.txt,
-        LineString.txt, etc for examples of the geometry APIs.
+        See the manual_ for comprehensive examples of usage. See also Operations.txt
+        and Predicates.txt under tests/ for more examples of the spatial operations and
+        predicates provided by Shapely. See also Point.txt, LineString.txt, etc for
+        examples of the geometry APIs.
+        
         
         Numpy integration
         -----------------
@@ -80,6 +85,7 @@ Description: Shapely
         >>> line.wkt
         'LINESTRING (1.0000000000000000 2.0000000000000000, 3.0000000000000000 4.0000000000000000)'
         
+        
         Python Geo Interface
         --------------------
         
@@ -107,6 +113,7 @@ Description: Shapely
         See http://trac.gispython.org/projects/PCL/wiki/PythonGeoInterface for more
         details on the interface.
         
+        
         Testing
         -------
         
@@ -116,7 +123,11 @@ Description: Shapely
         $ python point.py
         
         There are also two test runners under tests/. test_doctests.py requires
-        zope.testing. runalldoctests.py does not.
+        zope.testing. runalldoctests.py does not. Perhaps the easiest way to run the
+        tests is::
+        
+        $ python setup.py test
+        
         
         Support
         -------
@@ -131,9 +142,24 @@ Description: Shapely
         http://trac.gispython.org/projects/PCL/wiki/CommunityList
         
         
+        Credits
+        -------
+        
+        Sean Gillies (Pleiades)
+        Howard Butler (Hobu, Inc.)
+        Kai Lautaportti (Hexagon IT)
+        Frederic Junod (Camptocamp SA)
+        Eric Lemoine (Camptocamp SA)
+        Justin Bronn (GeoDjango) for ctypes inspiration
+        Artem Pavlenko (Mapnik) for help with GEOS DLLs
+        
+        Some of this work was supported by a grant (Pleiades) from the U.S. National
+        Endowment for the Humanities (http://www.neh.gov).
+        
+        
 Keywords: geometry topology
 Platform: UNKNOWN
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License

{Shapely-1.0b3 → Shapely-1.0rc1}/README.txt

@@ -1,8 +1,8 @@
 Shapely
 =======
 
-Shapely is a Python package for programming with geospatial geometries. It is
-based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about
+Shapely is a Python package for programming with 2D geospatial geometries. It
+is based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about
 coordinate and reference systems. Projection responsibility is left to specific
 applications. For more information, see:
 
@@ -12,14 +12,16 @@ applications. For more information, see:
 Shapely requires Python 2.4+. (I've also begun to port it to Python 3.0:
 http://zcologia.com/news/564/shapely-for-python-3-0/.)
 
+
 Dependencies
 ------------
 
-* libgeos_c (2.2.3, also reported to work with 3.0)
+* libgeos_c (2.2.3 or 3.0.0+)
 * Python ctypes_ (standard in Python 2.5+)
 
 .. _ctypes: http://pypi.python.org/pypi/ctypes/
 
+
 Installation
 ------------
 
@@ -31,26 +33,29 @@ with the setup script::
 
   $ sudo python setup.py install
 
-or by using the development buildout, which also provides libgeos_c::
+or by using the development buildout on Linux, which also provides libgeos_c::
+
+  $ svn co http://svn.gispython.org/svn/gispy/buildout/shapely.buildout/trunk shapely.buildout
+  $ cd shapely.buildout
+  $ python bootstrap.py
+  $ ./bin/buildout
 
- $ svn co http://svn.gispython.org/svn/gispy/buildout/shapely.buildout/trunk shapely.buildout
- $ cd shapely.buildout
- $ python bootstrap.py
- $ ./bin/buildout
 
 Usage
 -----
 
-Buffer a point::
+To buffer a point::
 
   >>> from shapely.geometry import Point
   >>> point = Point(-106.0, 40.0) # longitude, latitude
   >>> point.buffer(10.0)
   <shapely.geometry.polygon.Polygon object at ...>
 
-See Operations.txt and Predicates.txt under tests/ for more examples of the
-spatial operations and predicates provided by Shapely. Also see Point.txt,
-LineString.txt, etc for examples of the geometry APIs.
+See the manual_ for comprehensive examples of usage. See also Operations.txt
+and Predicates.txt under tests/ for more examples of the spatial operations and
+predicates provided by Shapely. See also Point.txt, LineString.txt, etc for
+examples of the geometry APIs.
+
 
 Numpy integration
 -----------------
@@ -72,6 +77,7 @@ Numpy arrays can also be adapted to Shapely points and linestrings::
   >>> line.wkt
   'LINESTRING (1.0000000000000000 2.0000000000000000, 3.0000000000000000 4.0000000000000000)'
 
+
 Python Geo Interface
 --------------------
 
@@ -99,6 +105,7 @@ geometry with the asShape factory::
 See http://trac.gispython.org/projects/PCL/wiki/PythonGeoInterface for more
 details on the interface.
 
+
 Testing
 -------
 
@@ -108,7 +115,11 @@ Several of the modules have docstring doctests::
   $ python point.py
 
 There are also two test runners under tests/. test_doctests.py requires
-zope.testing. runalldoctests.py does not.
+zope.testing. runalldoctests.py does not. Perhaps the easiest way to run the 
+tests is::
+
+  $ python setup.py test
+
 
 Support
 -------
@@ -122,3 +133,18 @@ If you have questions, please consider joining our community list:
 
 http://trac.gispython.org/projects/PCL/wiki/CommunityList
 
+
+Credits
+-------
+
+Sean Gillies (Pleiades)
+Howard Butler (Hobu, Inc.)
+Kai Lautaportti (Hexagon IT)
+Frederic Junod (Camptocamp SA)
+Eric Lemoine (Camptocamp SA)
+Justin Bronn (GeoDjango) for ctypes inspiration
+Artem Pavlenko (Mapnik) for help with GEOS DLLs
+
+Some of this work was supported by a grant (Pleiades) from the U.S. National
+Endowment for the Humanities (http://www.neh.gov).
+

{Shapely-1.0b3 → Shapely-1.0rc1}/Shapely.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.0
 Name: Shapely
-Version: 1.0b3
+Version: 1.0rc1
 Summary: Geospatial geometries, predicates, and operations
 Home-page: http://trac.gispython.org/projects/PCL/wiki/Shapely
 Author: Sean Gillies
@@ -9,8 +9,8 @@ License: BSD
 Description: Shapely
         =======
         
-        Shapely is a Python package for programming with geospatial geometries. It is
-        based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about
+        Shapely is a Python package for programming with 2D geospatial geometries. It
+        is based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about
         coordinate and reference systems. Projection responsibility is left to specific
         applications. For more information, see:
         
@@ -20,14 +20,16 @@ Description: Shapely
         Shapely requires Python 2.4+. (I've also begun to port it to Python 3.0:
         http://zcologia.com/news/564/shapely-for-python-3-0/.)
         
+        
         Dependencies
         ------------
         
-        * libgeos_c (2.2.3, also reported to work with 3.0)
+        * libgeos_c (2.2.3 or 3.0.0+)
         * Python ctypes_ (standard in Python 2.5+)
         
         .. _ctypes: http://pypi.python.org/pypi/ctypes/
         
+        
         Installation
         ------------
         
@@ -39,26 +41,29 @@ Description: Shapely
         
         $ sudo python setup.py install
         
-        or by using the development buildout, which also provides libgeos_c::
+        or by using the development buildout on Linux, which also provides libgeos_c::
         
         $ svn co http://svn.gispython.org/svn/gispy/buildout/shapely.buildout/trunk shapely.buildout
         $ cd shapely.buildout
         $ python bootstrap.py
         $ ./bin/buildout
         
+        
         Usage
         -----
         
-        Buffer a point::
+        To buffer a point::
         
         >>> from shapely.geometry import Point
         >>> point = Point(-106.0, 40.0) # longitude, latitude
         >>> point.buffer(10.0)
         <shapely.geometry.polygon.Polygon object at ...>
         
-        See Operations.txt and Predicates.txt under tests/ for more examples of the
-        spatial operations and predicates provided by Shapely. Also see Point.txt,
-        LineString.txt, etc for examples of the geometry APIs.
+        See the manual_ for comprehensive examples of usage. See also Operations.txt
+        and Predicates.txt under tests/ for more examples of the spatial operations and
+        predicates provided by Shapely. See also Point.txt, LineString.txt, etc for
+        examples of the geometry APIs.
+        
         
         Numpy integration
         -----------------
@@ -80,6 +85,7 @@ Description: Shapely
         >>> line.wkt
         'LINESTRING (1.0000000000000000 2.0000000000000000, 3.0000000000000000 4.0000000000000000)'
         
+        
         Python Geo Interface
         --------------------
         
@@ -107,6 +113,7 @@ Description: Shapely
         See http://trac.gispython.org/projects/PCL/wiki/PythonGeoInterface for more
         details on the interface.
         
+        
         Testing
         -------
         
@@ -116,7 +123,11 @@ Description: Shapely
         $ python point.py
         
         There are also two test runners under tests/. test_doctests.py requires
-        zope.testing. runalldoctests.py does not.
+        zope.testing. runalldoctests.py does not. Perhaps the easiest way to run the
+        tests is::
+        
+        $ python setup.py test
+        
         
         Support
         -------
@@ -131,9 +142,24 @@ Description: Shapely
         http://trac.gispython.org/projects/PCL/wiki/CommunityList
         
         
+        Credits
+        -------
+        
+        Sean Gillies (Pleiades)
+        Howard Butler (Hobu, Inc.)
+        Kai Lautaportti (Hexagon IT)
+        Frederic Junod (Camptocamp SA)
+        Eric Lemoine (Camptocamp SA)
+        Justin Bronn (GeoDjango) for ctypes inspiration
+        Artem Pavlenko (Mapnik) for help with GEOS DLLs
+        
+        Some of this work was supported by a grant (Pleiades) from the U.S. National
+        Endowment for the Humanities (http://www.neh.gov).
+        
+        
 Keywords: geometry topology
 Platform: UNKNOWN
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License

{Shapely-1.0b3 → Shapely-1.0rc1}/Shapely.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ HISTORY.txt
 LICENSE.txt
 README.txt
 setup.py
+setup_windows.py
 Shapely.egg-info/PKG-INFO
 Shapely.egg-info/SOURCES.txt
 Shapely.egg-info/dependency_links.txt

{Shapely-1.0b3 → Shapely-1.0rc1}/manual/manual.txt

@@ -9,9 +9,9 @@ The Shapely Manual
 :revision: 1.0
 :date: 2 January 2008
 
-:copyright: This work is licensed under a `Creative Commons Attribution-Share Alike 3.0 United States License`__.
+:copyright: This work is licensed under a `Creative Commons Attribution 3.0 United States License`__.
 
-.. __: http://creativecommons.org/licenses/by-sa/3.0/us/
+.. __: http://creativecommons.org/licenses/by/3.0/us/
 
 :abstract: This document describes the Shapely Python package for programming with geospatial geometries.
 
@@ -19,6 +19,7 @@ The Shapely Manual
 
 .. contents::
 
+
 Background
 ==========
 
@@ -33,6 +34,7 @@ Package Index record_.
 .. _record: http://pypi.python.org/pypi/Shapely
 .. _wiki: http://trac.gispython.org/projects/PCL/wiki/Shapely
 
+
 Geometries
 ==========
 
@@ -44,6 +46,7 @@ collections, and heterogeneous geometry collections. See the JTS illustration_.
 
 Shapely 1.0 does not provide circles, arcs, splines or the like.
 
+
 Factories
 ---------
 
@@ -111,6 +114,7 @@ Rings *must* be non-crossing, ordered coordinate sequences. The order may be
 clockwise or counter-clockwise. The resulting topology is independent of the
 order.
 
+
 Multipart Geometry Factories
 ----------------------------
 
@@ -156,6 +160,31 @@ holes) makes usage more clear
   >>> holes = [(b1, ..., bN), ...]
   >>> lines = MultiPolygon([(shell, holes), ...])
 
+
+Null Geometries
+---------------
+
+Null geometries can be created by calling the factories with no arguments, but
+almost nothing can be done with a null geometry.
+
+.. code-block:: python
+
+  >>> line_null = LineString()
+  >>> line_null.length
+  Traceback (most recent call last):
+  ...
+  ValueError: Null geometry supports no operations
+
+The coordinates of a null geometry *can* be set (see Section 3), after which
+the geometry is no longer null.
+
+.. code-block:: python
+
+  >>> l_null.coords = [(0, 0), (1, 1)]
+  >>> print l_null.length
+  1.414...
+
+
 Constructive Spatial Analysis Methods
 -------------------------------------
 
@@ -232,7 +261,6 @@ Centroid
   >>> centroid_point.wkt
   'POINT (-0.0000000000000000 -0.0000000000000000)'
 
-
 Convex Hull
 +++++++++++
 
@@ -264,6 +292,17 @@ Difference
   >>> polygon.difference(hull)
   <shapely.geometry.polygon.Polygon object at ...>
 
+Envelope
+++++++++
+
+.envelope : geometry
+  Returns the geometry's rectangular polygon envelope.
+
+.. code-block:: python
+
+  >>> polygon.envelope
+  <shapely.geometry.polygon.Polygon object at ...>
+
 Intersection
 ++++++++++++
 
@@ -302,6 +341,7 @@ not:
   >>> hull.union(polygon)
   <shapely.geometry.polygon.Polygon object at ...>
 
+
 Unary Spatial Predicates
 ------------------------
 
@@ -350,9 +390,10 @@ Examples
   >>> polygon.boundary.is_ring
   True
   >>> polygon.has_z
-  True
+  False
+
+(Note: that last return value exposes a bug in GEOS 2.2.3.)
 
-(Note: that last return value exposes a bug in GEOS 2.2.3. Should be False.)
 
 Binary Spatial Predicates
 -------------------------
@@ -437,6 +478,7 @@ Within
 .within(other): bool
   The inverse of *contains*.
 
+
 General Methods
 ---------------
 
@@ -462,6 +504,12 @@ Area
   Area of the geometry, unitless. Non-zero only for surfaces (polygons,
   multi-polygons).
 
+Bounds
+++++++
+
+.bounds : tuple
+  The geometry's (minx, miny, maxx, maxy) bounding box.
+
 Length
 ++++++
 
@@ -476,6 +524,8 @@ Examples
 
   >>> polygon.area
   4.0
+  >>> polygon.bounds
+  (-1.0, -1.0, 1.0, 1.0)
   >>> polygon.length
   8.0
   >>> line_r.length
@@ -483,6 +533,7 @@ Examples
   >>> line_b.length
   3.9812058474788765
 
+
 Geometry Parts and Coordinates
 ==============================
 
@@ -523,6 +574,7 @@ For line strings:
   >>> list(line_new.coords)
   [(1.0, 1.0), (2.0, 2.0)]
 
+
 Polygon Rings
 -------------
 
@@ -539,6 +591,7 @@ attribute of the geometry object.
 The interior boundaries (or holes) of a polygon can be accessed through the
 *interiors* attribute, which is a list of rings.
 
+
 Sub-geometries
 --------------
 
@@ -560,6 +613,22 @@ attribute of the geometry object, which is an iterator over the sub-geometries:
 The coordinate sequences of these sub-geometries can then be accessed as
 described above.
 
+
+Point Coordinates
+-----------------
+
+For the sake of convenience the coordinate values of points can be accessed
+read-only via **x**, **y**, and **z** attributes:
+
+.. code-block:: python
+
+  >>> point = Point(1.0, 1.0)
+  >>> point.x
+  1.0
+  >>> point.y
+  1.0
+
+
 Interoperation
 ==============
 
@@ -613,6 +682,7 @@ attribute. New geometries can be created from WKB data using the
   >>> loads(feature.GetGeometryRef().ExportToWkb())
   <shapely.geometry.polygon.Polygon object at ...>
 
+
 Python Sequences
 ----------------
 
@@ -652,6 +722,7 @@ used like
   >>> len(pa.interiors[0].coords)
   5
 
+
 Numpy Array Interface
 ---------------------
 
@@ -695,6 +766,7 @@ and a N x 2 array can be adapted to a line string
 
 There is no Numpy array representation of a polygon.
 
+
 Python Geo Interface
 --------------------
 
@@ -728,6 +800,7 @@ Or a simple placemark-type object:
 
 .. _Python geo interface: http://trac.gispython.org/projects/PCL/wiki/PythonGeoInterface
 
+
 Advanced Features
 =================
 
@@ -763,6 +836,7 @@ will be ultimately yielded from *iterops.contains*.
   >>> list(iterops.contains(polygon, iter((p, p.wkt) for p in points)))
   ['POINT (0.5000000000000000 0.5000000000000000)']
 
+
 Credits
 =======
 

{Shapely-1.0b3 → Shapely-1.0rc1}/setup.py

@@ -11,7 +11,7 @@ if version_info[:2] < (2,5):
 readme_text = file('README.txt', 'rb').read()
 
 setup(name          = 'Shapely',
-      version       = '1.0b3',
+      version       = '1.0rc1',
       description   = 'Geospatial geometries, predicates, and operations',
       license       = 'BSD',
       keywords      = 'geometry topology',
@@ -26,7 +26,7 @@ setup(name          = 'Shapely',
       #tests_require = ['numpy'], -- not working with "tests" command
       test_suite = 'tests.test_suite',
       classifiers   = [
-        'Development Status :: 4 - Beta',
+        'Development Status :: 5 - Production/Stable',
         'Intended Audience :: Developers',
         'Intended Audience :: Science/Research',
         'License :: OSI Approved :: BSD License',

Shapely-1.0rc1/setup_windows.py

@@ -0,0 +1,39 @@
+
+from setuptools import setup, Extension
+from sys import version_info
+
+# Require ctypes egg only for Python < 2.5
+install_requires = ['setuptools']
+if version_info[:2] < (2,5):
+    install_requires.append('ctypes')
+
+# Get text from README.txt
+readme_text = file('README.txt', 'rb').read()
+
+setup(name          = 'Shapely',
+      version       = '1.0rc1',
+      description   = 'Geospatial geometries, predicates, and operations',
+      license       = 'BSD',
+      keywords      = 'geometry topology',
+      author        = 'Sean Gillies',
+      author_email  = 'sgillies@frii.com',
+      maintainer    = 'Sean Gillies',
+      maintainer_email  = 'sgillies@frii.com',
+      url   = 'http://trac.gispython.org/projects/PCL/wiki/Shapely',
+      long_description = readme_text,
+      packages      = ['shapely', 'shapely.geometry'],
+      data_files=[('DLLs', ['DLLs/geos.dll', 'DLLs/geos_c.dll']),],
+      install_requires = install_requires,
+      #tests_require = ['numpy'], -- not working with "tests" command
+      test_suite = 'tests.test_suite',
+      classifiers   = [
+        'Development Status :: 5 - Production/Stable',
+        'Intended Audience :: Developers',
+        'Intended Audience :: Science/Research',
+        'License :: OSI Approved :: BSD License',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python',
+        'Topic :: Scientific/Engineering :: GIS',
+        ],
+)
+