shapely 2.1.1__tar.gz → 2.2.0rc1__tar.gz

{shapely-2.1.1 → shapely-2.2.0rc1}/CHANGES.txt

@@ -1,6 +1,29 @@
 Changes
 =======
 
+2.2.0 (unreleased)
+------------------
+
+Shapely 2.2.0 is a feature release with various new functions,
+improvements and bug fixes. Highlights include performance improvements for
+scalar attribute and method calls, and the new ``minimum_width``,
+``coverage_clean``, ``split``, ``transform_coordseq``, and ``get_segments``
+top-level functions.
+
+Shapely 2.2 supports Python >= 3.11, and binary wheels on PyPI include GEOS 3.14
+and are now also provided for the Windows ARM64 platform.
+Wheels are available for Python 3.15.
+
+For a full changelog, see
+https://shapely.readthedocs.io/en/latest/release/2.x.html#version-2-2-0
+
+
+2.1.2 (2025-09-24)
+------------------
+
+Wheels are available for Python 3.14 (and still include GEOS 3.13.1).
+
+
 2.1.1 (2025-05-19)
 ------------------
 

shapely-2.2.0rc1/CODE_OF_CONDUCT.md

@@ -0,0 +1,22 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic addresses, without explicit permission
+* Other unethical or unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. By adopting this Code of Conduct, project maintainers commit themselves to fairly and consistently applying these principles to every aspect of managing this project. Project maintainers who do not follow or enforce the Code of Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://contributor-covenant.org), version 1.2.0, available at [https://contributor-covenant.org/version/1/2/0/](https://contributor-covenant.org/version/1/2/0/)

shapely-2.2.0rc1/CONTRIBUTING.md

@@ -0,0 +1,17 @@
+Contributing to Shapely
+=======================
+
+All contributions are subject to the [Code of
+Conduct](https://github.com/shapely/shapely/blob/main/CODE_OF_CONDUCT.md).
+
+If you spot a bug or have an idea for a feature, please [create an
+issue](https://github.com/shapely/shapely/issues). For simple fixes or
+features, you can [create a pull
+request](https://github.com/shapely/shapely/pulls), but it is a good idea to
+have discussion on an issue before sinking a lot of time into a pull request.
+
+Shapely is a mature project and its primary needs are bug fixes and
+documentation. New features and major refactoring will be welcomed cautiously
+and slowly because the work of maintaining a new feature over the lifetime of
+the project can be several times larger than the work of the initial
+contribution. Please open a discussion about such work before starting.

{shapely-2.1.1 → shapely-2.2.0rc1}/PKG-INFO

@@ -1,41 +1,30 @@
 Metadata-Version: 2.4
 Name: shapely
-Version: 2.1.1
+Version: 2.2.0rc1
 Summary: Manipulation and analysis of geometric objects
+Keywords: geometry,topology,gis
 Author: Sean Gillies
 Maintainer: Shapely contributors
-License: BSD 3-Clause
-Project-URL: Documentation, https://shapely.readthedocs.io/
-Project-URL: Repository, https://github.com/shapely/shapely
-Keywords: geometry,topology,gis
+License-Expression: BSD-3-Clause
+License-File: LICENSE.txt
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: Unix
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Scientific/Engineering :: GIS
-Requires-Python: >=3.10
+Project-URL: Documentation, https://shapely.readthedocs.io/
+Project-URL: Repository, https://github.com/shapely/shapely
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.26
 Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-Requires-Dist: numpy>=1.21
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
-Requires-Dist: scipy-doctest; extra == "test"
-Provides-Extra: docs
-Requires-Dist: numpydoc==1.1.*; extra == "docs"
-Requires-Dist: matplotlib; extra == "docs"
-Requires-Dist: sphinx; extra == "docs"
-Requires-Dist: sphinx-book-theme; extra == "docs"
-Requires-Dist: sphinx-remove-toctrees; extra == "docs"
-Dynamic: license-file
 
 =======
 Shapely
@@ -107,7 +96,13 @@ Shapely functions generally support multithreading by releasing the Global
 Interpreter Lock (GIL) during execution. Normally in Python, the GIL prevents
 multiple threads from computing at the same time. Shapely functions
 internally release this constraint so that the heavy lifting done by GEOS can
-be done in parallel, from a single Python process.
+be done concurrently from a single Python process.
+
+When sharing NumPy array of geometries between threads, extreme care
+must be taken to avoid creating thread safety issues when mutating arrays. This
+holds for any NumPy array, but even more so for arrays of Shapely geometries.
+When overwriting a geometry in an array, the old geometry is deallocated. If at the
+same time another thread operates on that geometry, interpreter crashes will occur.
 
 Usage
 =====
@@ -142,11 +137,11 @@ See the documentation for more examples and guidance: https://shapely.readthedoc
 Requirements
 ============
 
-Shapely 2.1 requires
+Shapely 2.2 requires
 
-* Python >=3.10
-* GEOS >=3.9
-* NumPy >=1.21
+* Python >=3.11
+* GEOS >=3.10
+* NumPy >=1.26
 
 Installing Shapely
 ==================

{shapely-2.1.1 → shapely-2.2.0rc1}/README.rst

@@ -68,7 +68,13 @@ Shapely functions generally support multithreading by releasing the Global
 Interpreter Lock (GIL) during execution. Normally in Python, the GIL prevents
 multiple threads from computing at the same time. Shapely functions
 internally release this constraint so that the heavy lifting done by GEOS can
-be done in parallel, from a single Python process.
+be done concurrently from a single Python process.
+
+When sharing NumPy array of geometries between threads, extreme care
+must be taken to avoid creating thread safety issues when mutating arrays. This
+holds for any NumPy array, but even more so for arrays of Shapely geometries.
+When overwriting a geometry in an array, the old geometry is deallocated. If at the
+same time another thread operates on that geometry, interpreter crashes will occur.
 
 Usage
 =====
@@ -103,11 +109,11 @@ See the documentation for more examples and guidance: https://shapely.readthedoc
 Requirements
 ============
 
-Shapely 2.1 requires
+Shapely 2.2 requires
 
-* Python >=3.10
-* GEOS >=3.9
-* NumPy >=1.21
+* Python >=3.11
+* GEOS >=3.10
+* NumPy >=1.26
 
 Installing Shapely
 ==================

shapely-2.2.0rc1/_version.py

@@ -0,0 +1,4 @@
+"""Module to show version information for the installed package."""
+
+__version__ = "2.2.0rc1"
+__git_version__ = "4b1850b3292f681a91d3826c5ea9bd32bebe302f"

shapely-2.2.0rc1/docs/Makefile

@@ -0,0 +1,89 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html      to make standalone HTML files"
+	@echo "  dirhtml   to make HTML files named index.html in directories"
+	@echo "  pickle    to make pickle files"
+	@echo "  json      to make JSON files"
+	@echo "  htmlhelp  to make HTML files and a HTML help project"
+	@echo "  qthelp    to make HTML files and a qthelp project"
+	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  changes   to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck to check all external links for integrity"
+	@echo "  doctest   to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/* build/plot_directive/* reference/* _reference.rst
+
+html:
+	$(SPHINXBUILD) -n -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Shapely.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Shapely.qhc"
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
+	      "run these through (pdf)latex."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."

shapely-2.2.0rc1/docs/_templates/autosummary/class.rst

@@ -0,0 +1,7 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:
+   :inherited-members:

shapely-2.2.0rc1/docs/code/buffer.py

@@ -0,0 +1,35 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import LineString
+from shapely.plotting import plot_polygon, plot_line
+
+from figures import SIZE, BLUE, GRAY, set_limits
+
+line = LineString([(0, 0), (1, 1), (0, 2), (2, 2), (3, 1), (1, 0)])
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+# 1
+ax = fig.add_subplot(121)
+
+plot_line(line, ax=ax, add_points=False, color=GRAY, linewidth=3)
+
+dilated = line.buffer(0.5, cap_style=3)
+plot_polygon(dilated, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('a) dilation, cap_style=3')
+
+set_limits(ax, -1, 4, -1, 3)
+
+#2
+ax = fig.add_subplot(122)
+
+plot_polygon(dilated, ax=ax, add_points=False, color=GRAY, alpha=0.5)
+
+eroded = dilated.buffer(-0.3)
+plot_polygon(eroded, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('b) erosion, join_style=1')
+
+set_limits(ax, -1, 4, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/buffer_single_side.py

@@ -0,0 +1,35 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import LineString
+from shapely.plotting import plot_polygon, plot_line
+
+from figures import SIZE, BLUE, GRAY, set_limits
+
+line = LineString([(0, 0), (1, 1), (0, 2), (2, 2), (3, 1), (1, 0)])
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+# 1
+ax = fig.add_subplot(121)
+
+plot_line(line, ax=ax, add_points=False, color=GRAY, linewidth=3)
+
+left_hand_side = line.buffer(0.5, single_sided=True)
+plot_polygon(left_hand_side, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('a) left hand buffer')
+
+set_limits(ax, -1, 4, -1, 3)
+
+#2
+ax = fig.add_subplot(122)
+
+plot_line(line, ax=ax, add_points=False, color=GRAY, linewidth=3)
+
+right_hand_side = line.buffer(-0.3, single_sided=True)
+plot_polygon(right_hand_side, ax=ax, add_points=False, color=GRAY, alpha=0.5)
+
+ax.set_title('b) right hand buffer')
+
+set_limits(ax, -1, 4, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/convex_hull.py

@@ -0,0 +1,35 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import MultiPoint
+from shapely.plotting import plot_polygon, plot_line, plot_points
+
+from figures import GRAY, BLUE, SIZE, set_limits
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+# 1
+ax = fig.add_subplot(121)
+
+points2 = MultiPoint([(0, 0), (2, 2)])
+plot_points(points2, ax=ax, color=GRAY)
+
+hull2 = points2.convex_hull
+plot_line(hull2, ax=ax, add_points=False, color=BLUE, zorder=3)
+
+ax.set_title('a) N = 2')
+
+set_limits(ax, -1, 4, -1, 3)
+
+#2
+ax = fig.add_subplot(122)
+
+points1 = MultiPoint([(0, 0), (1, 1), (0, 2), (2, 2), (3, 1), (1, 0)])
+plot_points(points1, ax=ax, color=GRAY)
+
+hull1 = points1.convex_hull
+plot_polygon(hull1, ax=ax, add_points=False, color=BLUE, zorder=3, alpha=0.5)
+
+ax.set_title('b) N > 2')
+
+set_limits(ax, -1, 4, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/coverage_simplify.py

@@ -0,0 +1,53 @@
+import urllib.request
+
+import numpy as np
+import matplotlib.pyplot as plt
+
+import shapely
+from shapely.plotting import plot_polygon
+
+from figures import SIZE, BLUE
+
+## Downloading and preprocessing data
+
+# download countries geojson from https://datahub.io/core/geo-countries
+with urllib.request.urlopen("https://datahub.io/core/geo-countries/_r/-/data/countries.geojson") as f:
+    geojson = f.read().decode("utf-8")
+
+geoms = np.asarray(shapely.from_geojson(geojson).geoms)
+
+# select countries of Africa
+clip_polygon = shapely.from_wkt("POLYGON ((-23.714863 14.983714, 0.434636 -51.130505, 52.292267 -50.120681, 60.184885 -22.43548, 57.448957 14.358282, 44.596307 11.524365, 33.72577 34.648769, 7.226985 39.73104, -16.429284 33.649053, -23.714863 14.983714))")
+geoms_africa = geoms[shapely.within(geoms, clip_polygon)]
+
+# remove small islands for nicer illustration of coverage
+temp = geoms_africa[shapely.area(geoms_africa) > 0.1]
+parts, indices = shapely.get_parts(temp, return_index=True)
+mask = shapely.area(parts) > 0.08
+temp = shapely.multipolygons(parts[mask], indices=indices[mask])
+
+# set precision to improve coverage validity
+geoms_africa2 = shapely.set_precision(temp, 0.001)
+
+## Coverage simplify
+
+geoms_africa_simplified = shapely.coverage_simplify(geoms_africa2, tolerance=5.0)
+
+# plot
+fig, (ax1, ax2) = plt.subplots(ncols=2, figsize=SIZE, dpi=90)
+
+for geom in geoms_africa2:
+    plot_polygon(geom, ax=ax1, add_points=False, color=BLUE)
+
+ax1.set_title('a) original data')
+ax1.axis("off")
+ax1.set_aspect("equal")
+
+for geom in geoms_africa_simplified:
+    plot_polygon(geom, ax=ax2, add_points=False, color=BLUE)
+
+ax2.set_title('b) coverage simplified')
+ax2.axis("off")
+ax2.set_aspect("equal")
+
+plt.show()

shapely-2.2.0rc1/docs/code/difference.py

@@ -0,0 +1,38 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import Point
+from shapely.plotting import plot_polygon
+
+from figures import SIZE, BLUE, GRAY, set_limits
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+a = Point(1, 1).buffer(1.5)
+b = Point(2, 1).buffer(1.5)
+
+# 1
+ax = fig.add_subplot(121)
+
+plot_polygon(a, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+plot_polygon(b, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+
+c = a.difference(b)
+plot_polygon(c, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('a.difference(b)')
+
+set_limits(ax, -1, 4, -1, 3)
+
+#2
+ax = fig.add_subplot(122)
+
+plot_polygon(a, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+plot_polygon(b, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+
+c = b.difference(a)
+plot_polygon(c, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('b.difference(a)')
+
+set_limits(ax, -1, 4, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/figures.py

@@ -0,0 +1,30 @@
+from math import sqrt
+from shapely import affinity
+
+GM = (sqrt(5)-1.0)/2.0
+W = 8.0
+H = W*GM
+SIZE = (W, H)
+
+BLUE = '#6699cc'
+GRAY = '#999999'
+DARKGRAY = '#333333'
+YELLOW = '#ffcc33'
+GREEN = '#339933'
+RED = '#ff3333'
+BLACK = '#000000'
+
+
+def add_origin(ax, geom, origin):
+    x, y = xy = affinity.interpret_origin(geom, origin, 2)
+    ax.plot(x, y, 'o', color=GRAY, zorder=1)
+    ax.annotate(str(xy), xy=xy, ha='center',
+                textcoords='offset points', xytext=(0, 8))
+
+
+def set_limits(ax, x0, xN, y0, yN):
+    ax.set_xlim(x0, xN)
+    ax.set_xticks(range(x0, xN+1))
+    ax.set_ylim(y0, yN)
+    ax.set_yticks(range(y0, yN+1))
+    ax.set_aspect("equal")

shapely-2.2.0rc1/docs/code/geometrycollection.py

@@ -0,0 +1,39 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import LineString
+from shapely.plotting import plot_line, plot_points
+
+from figures import BLUE, GRAY, YELLOW, GREEN, SIZE, set_limits
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+a = LineString([(0, 0), (1, 1), (1,2), (2,2)])
+b = LineString([(0, 0), (1, 1), (2,1), (2,2)])
+
+# 1: disconnected multilinestring
+ax = fig.add_subplot(121)
+
+plot_line(a, ax, add_points=False, color=YELLOW, alpha=0.5)
+plot_line(b, ax, add_points=False, color=GREEN, alpha=0.5)
+plot_points(a, ax=ax, color=GRAY)
+plot_points(b, ax=ax, color=GRAY)
+
+ax.set_title('a) lines')
+
+set_limits(ax, -1, 3, -1, 3)
+
+#2: invalid self-touching ring
+ax = fig.add_subplot(122)
+
+x = a.intersection(b)
+
+plot_line(a, ax=ax, color=GRAY, add_points=False)
+plot_line(b, ax=ax, color=GRAY, add_points=False)
+
+plot_line(x.geoms[0], ax=ax, color=BLUE)
+plot_points(x.geoms[1], ax=ax, color=BLUE)
+
+ax.set_title('b) collection')
+
+set_limits(ax, -1, 3, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/intersection-sym-difference.py

@@ -0,0 +1,38 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import Point
+from shapely.plotting import plot_polygon
+
+from figures import SIZE, BLUE, GRAY, set_limits
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+a = Point(1, 1).buffer(1.5)
+b = Point(2, 1).buffer(1.5)
+
+# 1
+ax = fig.add_subplot(121)
+
+plot_polygon(a, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+plot_polygon(b, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+
+c = a.intersection(b)
+plot_polygon(c, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('a.intersection(b)')
+
+set_limits(ax, -1, 4, -1, 3)
+
+#2
+ax = fig.add_subplot(122)
+
+plot_polygon(a, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+plot_polygon(b, ax=ax, add_points=False, color=GRAY, alpha=0.2)
+
+c = a.symmetric_difference(b)
+plot_polygon(c, ax=ax, add_points=False, color=BLUE, alpha=0.5)
+
+ax.set_title('a.symmetric_difference(b)')
+
+set_limits(ax, -1, 4, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/linearring.py

@@ -0,0 +1,31 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import LinearRing
+from shapely.plotting import plot_line, plot_points
+
+from figures import SIZE, BLUE, GRAY, RED, set_limits
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+# 1: valid ring
+ax = fig.add_subplot(121)
+ring = LinearRing([(0, 0), (0, 2), (1, 1), (2, 2), (2, 0), (1, 0.8), (0, 0)])
+
+plot_line(ring, ax=ax, add_points=False, color=BLUE, alpha=0.7)
+plot_points(ring, ax=ax, color=GRAY, alpha=0.7)
+
+ax.set_title('a) valid')
+
+set_limits(ax, -1, 3, -1, 3)
+
+#2: invalid self-touching ring
+ax = fig.add_subplot(122)
+ring2 = LinearRing([(0, 0), (0, 2), (1, 1), (2, 2), (2, 0), (1, 1), (0, 0)])
+
+plot_line(ring2, ax=ax, add_points=False, color=RED, alpha=0.7)
+plot_points(ring2, ax=ax, color=GRAY, alpha=0.7)
+
+ax.set_title('b) invalid')
+
+set_limits(ax, -1, 3, -1, 3)
+
+plt.show()

shapely-2.2.0rc1/docs/code/linestring.py

@@ -0,0 +1,33 @@
+import matplotlib.pyplot as plt
+from shapely.geometry import LineString
+from shapely.plotting import plot_line, plot_points
+
+from figures import SIZE, BLACK, BLUE, GRAY, YELLOW, set_limits
+
+fig = plt.figure(1, figsize=SIZE, dpi=90)
+
+# 1: simple line
+ax = fig.add_subplot(121)
+line = LineString([(0, 0), (1, 1), (0, 2), (2, 2), (3, 1), (1, 0)])
+
+plot_line(line, ax=ax, add_points=False, color=BLUE, alpha=0.7)
+plot_points(line, ax=ax, color=GRAY, alpha=0.7)
+plot_points(line.boundary, ax=ax, color=BLACK)
+
+ax.set_title('a) simple')
+
+set_limits(ax, -1, 4, -1, 3)
+
+# 2: complex line
+ax = fig.add_subplot(122)
+line2 = LineString([(0, 0), (1, 1), (0, 2), (2, 2), (-1, 1), (1, 0)])
+
+plot_line(line2, ax=ax, add_points=False, color=YELLOW, alpha=0.7)
+plot_points(line2, ax=ax, color=GRAY, alpha=0.7)
+plot_points(line2.boundary, ax=ax, color=BLACK)
+
+ax.set_title('b) complex')
+
+set_limits(ax, -2, 3, -1, 3)
+
+plt.show()