Added documentation for CoordinateSequence
@@ -790,6 +790,54 @@ longer empty.
>>> line.bounds
(0.0, 0.0, 1.0, 1.0)
+Coordinate sequences
+--------------------
+
+The list of coordinates that describe a geometry are represented as the
+``CoordinateSequence`` object. These sequences should not be initialised
+directly, but can be accessed from an existing geometry as the
+``Geometry.coords`` property.
+
+.. code-block:: pycon
+
+ >>> line = LineString([(0, 1), (2, 3), (4, 5)])
+ >>> line.coords
+ <shapely.coords.CoordinateSequence object at 0x00000276EED1C7F0>
+
+Coordinate sequences can be indexed, sliced and iterated over as if they were a
+list of coordinate tuples.
+
+.. code-block:: pycon
+
+ >>> line.coords[0]
+ (0.0, 1.0)
+ >>> line.coords[1:]
+ [(2.0, 3.0), (4.0, 5.0)]
+ >>> for x, y in line.coords:
+ ... print("x={}, y={}".format(x, y))
+ ...
+ x=0.0, y=1.0
+ x=2.0, y=3.0
+ x=4.0, y=5.0
+
+Polygons have a coordinate sequence for their exterior and each of their
+interior rings.
+
+.. code-block:: pycon
+
+ >>> poly = Polygon([(0, 0), (0, 1), (1, 1), (0, 0)])
+ >>> poly.exterior.coords
+ <shapely.coords.CoordinateSequence object at 0x00000276EED1C048>
+
+Multipart geometries do not have a coordinate sequence. Instead the coordinate
+sequences are stored on their component geometries.
+
+.. code-block:: pycon
+
+ >>> p = MultiPoint([(0, 0), (1, 1), (2, 2)])
+ >>> p[2].coords
+ <shapely.coords.CoordinateSequence object at 0x00000276EFB9B320>
+
Linear Referencing Methods
--------------------------
