shapely 1.2.17__tar.gz → 1.2.18__tar.gz

{Shapely-1.2.17 → Shapely-1.2.18}/CHANGES.txt

@@ -1,6 +1,14 @@
 Changes
 =======
 
+1.2.18 (2013-07-23)
+--------------------
+- Add shapely.ops.transform.
+- Permit empty sequences in collection constructors (#49, #50).
+- Individual polygons in MultiPolygon.__geo_interface__ are changed to tuples
+  to match Polygon.__geo_interface__ (#51).
+- Add shapely.ops.polygonize_full (#57).
+
 1.2.17 (2013-01-27)
 -------------------
 - Avoid circular import between wkt/wkb and geometry.base by moving calls

{Shapely-1.2.17/Shapely.egg-info → Shapely-1.2.18}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 1.0
+Metadata-Version: 1.1
 Name: Shapely
-Version: 1.2.17
+Version: 1.2.18
 Summary: Geometric objects, predicates, and operations
 Home-page: https://github.com/Toblerity/Shapely
 Author: Sean Gillies
@@ -14,8 +14,8 @@ Description: =======
         Pythonistas.
         
         .. image:: http://farm3.staticflickr.com/2738/4511827859_b5822043b7_o_d.png
-        :width: 800
-        :height: 400
+           :width: 800
+           :height: 400
         
         Shapely is a BSD-licensed Python package for manipulation and analysis of
         planar geometric objects. It is based on the widely deployed GEOS_ (the engine
@@ -24,7 +24,6 @@ Description: =======
         concerned with data formats or coordinate systems, but can be readily
         integrated with packages that are. For more details, see:
         
-        * Shapely wiki_
         * Shapely manual_
         * Shapely `example apps`_
         
@@ -43,11 +42,17 @@ Description: =======
         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
+          $ pip install Shapely
         
         or from a source distribution with the setup script::
         
-        $ python setup.py install
+          $ python setup.py install
+        
+        .. warning:: Windows users:
+           do not under any circumstances use pip (or easy_install) to uninstall
+           Shapely versions < 1.2.17. Due to the way Shapely used to install its GEOS
+           DLL and a distribute or setuptools bug, your Python installation may be
+           broken by an uninstall command. Shapely 1.2.17 will uninstall safely.
         
         Usage
         =====
@@ -55,12 +60,12 @@ Description: =======
         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
+          >>> 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`_.
@@ -72,38 +77,51 @@ Description: =======
         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)'
+          >>> 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.::
         
-        >>> 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]])
+          >>> 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 always exactly what one
+        That yields a Numpy array of [x, y] arrays. This is not always exactly what one
         wants for plotting shapes with Matplotlib (for example), so Shapely 1.2 adds
         a `xy` property for obtaining 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,  ...])
+          >>> 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, ...)'
+          >>> from shapely.geometry import asLineString
+          >>> asLineString(ag).length
+          62.806623139095073
+          >>> asLineString(ag).wkt
+          'LINESTRING (10.0000000000000000 0.0000000000000000, ...)'
+        
+        Shapely can also integrate with other Python GIS packages using data modeled
+        after GeoJSON.
+        
+        .. sourcecode:: pycon
+        
+          >>> import json
+          >>> from shapely.geometry import mapping, shape
+          >>> s = shape(json.loads('{"type": "Point", "coordinates": [0.0, 0.0]}'))
+          >>> s
+          <shapely.geometry.point.Point object at 0x...>
+          >>> print(json.dumps(mapping(s)))
+          {"type": "Point", "coordinates": [0.0, 0.0]}
         
         Testing
         =======
@@ -111,7 +129,7 @@ Description: =======
         Shapely uses a Zope-stye suite of unittests and doctests, exercised via
         setup.py.::
         
-        $ python setup.py test
+          $ python setup.py test
         
         Nosetests won't run the tests properly; Zope doctest suites are not currently
         supported well by nose.
@@ -119,15 +137,17 @@ Description: =======
         Support
         =======
         
-        Bugs may be reported and questions asked via https://github.com/Toblerity/Shapely.
+        Please discuss Shapely with us at
+        http://lists.gispython.org/mailman/listinfo/community.
+        
+        Bugs may be reported at https://github.com/Toblerity/Shapely.
         
         
         
         .. _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
+        .. _example apps: https://github.com/sgillies/shapely/tree/master/shapely/examples
         .. _manual: http://toblerity.github.com/shapely/manual.html
         .. _Pleiades: http://pleiades.stoa.org
         
@@ -164,16 +184,24 @@ Description: =======
         U.S. National Endowment for the Humanities (http://www.neh.gov).
         
         .. |eaigue| unicode:: U+00E9
-        :trim:
+           :trim:
         .. _Pleiades: http://pleiades.stoa.org
         
         Changes
         =======
         
+        1.2.18 (2013-07-23)
+        --------------------
+        - Add shapely.ops.transform.
+        - Permit empty sequences in collection constructors (#49, #50).
+        - Individual polygons in MultiPolygon.__geo_interface__ are changed to tuples
+          to match Polygon.__geo_interface__ (#51).
+        - Add shapely.ops.polygonize_full (#57).
+        
         1.2.17 (2013-01-27)
         -------------------
         - Avoid circular import between wkt/wkb and geometry.base by moving calls
-        to GEOS serializers to the latter module.
+          to GEOS serializers to the latter module.
         - Set _ndim when unpickling (issue #6).
         - Don't install DLLs to Python's DLL directory (#37).
         - Add affinity module of affine transformation (#31).
@@ -186,32 +214,32 @@ Description: =======
         - Add geos_version_string attribute to shapely.geos.
         - Ensure parent is set when child geometry is accessed.
         - Generate _speedups.c using Cython when building from repo when missing,
-        stale, or the build target is "sdist".
+          stale, or the build target is "sdist".
         - The is_simple predicate of invalid, self-intersecting linear rings now
-        returns ``False``.
+          returns ``False``.
         - Remove VERSION.txt from repo, it's now written by the distutils setup script
-        with value of shapely.__version__.
+          with value of shapely.__version__.
         
         1.2.15 (2012-06-27)
         -------------------
         - Eliminate numerical sensitivity in a method chaining test (Debian bug
-        #663210).
+          #663210).
         - Account for cascaded union of random buffered test points being a polygon
-        or multipolygon (Debian bug #666655).
+          or multipolygon (Debian bug #666655).
         - Use Cython to build speedups if it is installed.
         - Avoid stumbling over SVN revision numbers in GEOS C API version strings.
         
         1.2.14 (2012-01-23)
         -------------------
         - A geometry's coords property is now sliceable, yielding a list of coordinate
-        values.
+          values.
         - Homogeneous collections are now sliceable, yielding a new collection of the
-        same type.
+          same type.
         
         1.2.13 (2011-09-16)
         -------------------
         - Fixed errors in speedups on 32bit systems when GEOS references memory above
-        2GB.
+          2GB.
         - Add shapely.__version__ attribute.
         - Update the manual.
         
@@ -256,7 +284,7 @@ Description: =======
         1.2.6 (2010-10-21)
         ------------------
         - The geoms property of an empty collection yields [] instead of a ValueError
-        (#3).
+          (#3).
         - The coords and geometry type sproperties have the same behavior as above.
         - Ensure that z values carry through into products of operations (#4).
         
@@ -270,7 +298,7 @@ Description: =======
         - Raise AttributeError when there's no backend support for a method.
         - Raise OSError if libgeos_c.so (or variants) can't be found and loaded.
         - Add geos_c DLL loading support for linux platforms where find_library doesn't
-        work.
+          work.
         
         1.2.3 (2010-08-17)
         ------------------
@@ -310,8 +338,8 @@ Description: =======
         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.
+          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.
         
@@ -330,8 +358,8 @@ Description: =======
         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).
+          regarding required Python version (>=2.5,<3) and external dependency
+          (libgeos_c >= 3.1).
         
         1.2a6 (2010-02-09)
         ------------------
@@ -342,9 +370,9 @@ Description: =======
         1.2a1 (2010-01-20)
         ------------------
         - Proper prototyping of WKB writer, and avoidance of errors on 64-bit systems
-        (#191).
+          (#191).
         - Prototype libgeos_c functions in a way that lets py2exe apps import shapely
-        (#189).
+          (#189).
         
         1.2 Branched (2009-09-19)
         
@@ -355,7 +383,7 @@ Description: =======
         1.0.11 (2008-11-20)
         -------------------
         - Work around bug in GEOS 2.2.3, GEOSCoordSeq_getOrdinate not exported properly
-        (#178).
+          (#178).
         
         1.0.10 (2008-11-17)
         -------------------
@@ -368,7 +396,7 @@ Description: =======
         1.0.8 (2008-11-01)
         ------------------
         - Fill out GEOS function result and argument types to prevent faults on a
-        64-bit arch.
+          64-bit arch.
         
         1.0.7 (2008-08-22)
         ------------------
@@ -385,14 +413,14 @@ Description: =======
         ------------------
         - Added access to GEOS polygonizer function.
         - Raise exception when insufficient coordinate tuples are passed to LinearRing
-        constructor (#164).
+          constructor (#164).
         
         1.0.4 (2008-05-01)
         ------------------
         - Disentangle Python and topological equality (#163).
         - Add shape(), a factory that copies coordinates from a geo interface provider.
-        To be used instead of asShape() unless you really need to store coordinates
-        outside shapely for efficient use in other code.
+          To be used instead of asShape() unless you really need to store coordinates
+          outside shapely for efficient use in other code.
         - Cache GEOS geometries in adapters (#163).
         
         1.0.3 (2008-04-09)
@@ -407,7 +435,7 @@ Description: =======
         1.0.1 (2008-02-08)
         ------------------
         - Allow chaining expressions involving coordinate sequences and geometry parts
-        (#151).
+          (#151).
         - Protect against abnormal use of coordinate accessors (#152).
         - Coordinate sequences now implement the numpy array protocol (#153).
         

{Shapely-1.2.17 → Shapely-1.2.18}/README.rst

@@ -16,7 +16,6 @@ is traded for the ability to execute with blazing speed. Shapely is not
 concerned with data formats or coordinate systems, but can be readily
 integrated with packages that are. For more details, see:
 
-* Shapely wiki_
 * Shapely manual_
 * Shapely `example apps`_
 
@@ -41,6 +40,12 @@ or from a source distribution with the setup script::
 
   $ python setup.py install
 
+.. warning:: Windows users:
+   do not under any circumstances use pip (or easy_install) to uninstall
+   Shapely versions < 1.2.17. Due to the way Shapely used to install its GEOS
+   DLL and a distribute or setuptools bug, your Python installation may be
+   broken by an uninstall command. Shapely 1.2.17 will uninstall safely.
+
 Usage
 =====
 
@@ -57,7 +62,7 @@ buffering a point::
 See the manual_ for comprehensive usage snippets and the dissolve.py and
 intersect.py `example apps`_.
 
-Integration 
+Integration
 ===========
 
 Shapely does not read or write data files, but it can serialize and deserialize
@@ -80,7 +85,7 @@ 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
+That yields a Numpy array of [x, y] arrays. This is not always exactly what one
 wants for plotting shapes with Matplotlib (for example), so Shapely 1.2 adds
 a `xy` property for obtaining separate arrays of coordinate x and y values.::
 
@@ -97,6 +102,19 @@ Numpy arrays can also be adapted to Shapely linestrings::
   >>> asLineString(ag).wkt
   'LINESTRING (10.0000000000000000 0.0000000000000000, ...)'
 
+Shapely can also integrate with other Python GIS packages using data modeled
+after GeoJSON.
+
+.. sourcecode:: pycon
+
+  >>> import json
+  >>> from shapely.geometry import mapping, shape
+  >>> s = shape(json.loads('{"type": "Point", "coordinates": [0.0, 0.0]}'))
+  >>> s
+  <shapely.geometry.point.Point object at 0x...>
+  >>> print(json.dumps(mapping(s)))
+  {"type": "Point", "coordinates": [0.0, 0.0]}
+
 Testing
 =======
 
@@ -111,15 +129,17 @@ supported well by nose.
 Support
 =======
 
-Bugs may be reported and questions asked via https://github.com/Toblerity/Shapely.
+Please discuss Shapely with us at
+http://lists.gispython.org/mailman/listinfo/community.
+
+Bugs may be reported at https://github.com/Toblerity/Shapely.
 
 .. include:: CREDITS.txt
 
 .. _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
+.. _example apps: https://github.com/sgillies/shapely/tree/master/shapely/examples
 .. _manual: http://toblerity.github.com/shapely/manual.html
 .. _Pleiades: http://pleiades.stoa.org