shapely 1.2.1__tar.gz → 1.2.3__tar.gz

{Shapely-1.2.1 → Shapely-1.2.3}/CHANGES.txt

@@ -1,5 +1,14 @@
 All tickets are children of http://trac.gispython.org/lab/ticket.
 
+1.2.3 (2010-08-17)
+------------------
+- Add mapping function.
+- Fix problem with GEOSisValidReason symbol for GEOS < 3.1.
+
+1.2.2 (2010-07-23)
+------------------
+- Add representative_point method.
+
 1.2.1 (2010-06-23)
 ------------------
 - Fixed bounds of singular polygons.

{Shapely-1.2.1 → Shapely-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.0
 Name: Shapely
-Version: 1.2.1
+Version: 1.2.3
 Summary: Geometric objects, predicates, and operations
 Home-page: http://trac.gispython.org/lab/wiki/Shapely
 Author: Sean Gillies

{Shapely-1.2.1 → Shapely-1.2.3}/Shapely.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.0
 Name: Shapely
-Version: 1.2.1
+Version: 1.2.3
 Summary: Geometric objects, predicates, and operations
 Home-page: http://trac.gispython.org/lab/wiki/Shapely
 Author: Sean Gillies

{Shapely-1.2.1 → Shapely-1.2.3}/Shapely.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ Shapely.egg-info/SOURCES.txt
 Shapely.egg-info/dependency_links.txt
 Shapely.egg-info/top_level.txt
 docs/manual.txt
+docs/_build/html/_sources/manual.txt
 examples/dissolve.py
 examples/intersect.py
 shapely/__init__.py
@@ -63,6 +64,7 @@ shapely/tests/test_doctests.py
 shapely/tests/test_emptiness.py
 shapely/tests/test_equality.py
 shapely/tests/test_geomseq.py
+shapely/tests/test_mapping.py
 shapely/tests/test_prepared.py
 shapely/tests/test_singularity.py
 shapely/tests/test_validation.py

{Shapely-1.2.1/docs → Shapely-1.2.3/docs/_build/html/_sources}/manual.txt

@@ -3,8 +3,8 @@ The Shapely 1.2 User Manual (Preview)
 =====================================
 
 :Author: Sean Gillies, <sean.gillies@gmail.com>
-:Revision: 1.2
-:Date: 24 May 2010
+:Revision: 1.2.2
+:Date: 10 August 2010
 :Copyright: 
   This work is licensed under a `Creative Commons Attribution 3.0
   United States License`__.
@@ -208,6 +208,22 @@ General Attributes and Methods
   >>> Point(0,0).distance(Point(1,1))
   1.4142135623730951
 
+.. method:: object.representative_point()
+
+  Returns a cheaply computed point that is guaranteed to be within the 
+  geometric object.
+
+.. note::
+  This is not in general the same as the centroid.
+
+.. sourcecode:: pycon
+
+  >>> donut = Point(0, 0).buffer(2.0).difference(Point(0, 0).buffer(1.0))
+  >>> donut.centroid.wkt
+  'POINT (-0.0000000000000001 -0.0000000000000000)'
+  >>> donut.representative_point().wkt
+  'POINT (-1.5000000000000000 0.0000000000000000)'
+
 .. _points:
 
 Points
@@ -1366,8 +1382,8 @@ Figure 1. Convex hull (blue) of 2 points (left) and of 6 points (right).
 
 .. attribute:: object.envelope
 
-  Returns a representation of the point or smallest rectangular polygon that
-  contains the object.
+  Returns a representation of the point or smallest rectangular polygon (with
+  sides parallel to the coordinate axes) that contains the object.
 
 .. sourcecode:: pycon
 
@@ -1501,7 +1517,7 @@ first use the :func:`prepared.prep` function.
 .. sourcecode:: pycon
 
   >>> from shapely.geometry import Point
-  >>> from shapely.prepared import polyprep
+  >>> from shapely.prepared import prep
   >>> points = [...] # large list of points
   >>> polygon = Point(0.0, 0.0).buffer(1.0)
   >>> prepared_polygon = prep(polygon)
@@ -1514,6 +1530,26 @@ Prepared geometries instances have the following methods: ``contains``,
 same arguments and usage as their counterparts in non-prepared geometric
 objects.
 
+Diagnostics
+-----------
+
+.. function:: validation.explain_validity(ob):
+
+  Returns a string explaining the validity or invalidity of the object.
+
+  `New in version 1.2.1`.
+
+The messages may or may not have a representation of a problem point that can
+be parsed out.
+
+.. sourcecode:: python
+
+  >>> coords = [(0, 0), (0, 2), (1, 1), (2, 2), (2, 0), (1, 1), (0, 0)]
+  >>> p = Polygon(coords)
+  >>> from shapely.validation import explain_validity
+  >>> explain_validity(p)
+  'Ring Self-intersection[1 1]'
+
 Interoperation
 ==============
 
@@ -1673,6 +1709,26 @@ Or a simple placemark-type object:
   >>> list(shape.coords)
   [(0.0, 0.0)]
 
+The GeoJSON-like mapping of a geometric object can be obtained using
+:func:`shapely.geometry.mapping`.
+
+.. function:: shapely.geometry.mapping(ob)
+
+   Return a new, independent geometry with coordinates `copied` from the
+   context.
+
+For example, using the same `GeoThing` class:
+
+.. sourcecode:: pycon
+
+  >>> from shapely.geometry import mapping
+  >>> thing = GeoThing({"type": "Point", "coordinates": (0.0, 0.0)})
+  >>> m = mapping(thing)
+  >>> m['type']
+  'Point'
+  >>> m['coordinates']
+  (0.0, 0.0)}
+
 Conclusion
 ==========