shapely

Pre-release

This release is a pre-release and may not be stable for production use.

Manipulation and analysis of geometric objects in the Cartesian plane.

https://c2.staticflickr.com/6/5560/31301790086_b3472ea4e9_c.jpg

Shapely is a BSD-licensed Python package for manipulation and analysis of planar geometric objects. It is using the widely deployed open-source geometry library GEOS (the engine of PostGIS, and a port of JTS). Shapely wraps GEOS geometries and operations to provide both a feature rich Geometry interface for singular (scalar) geometries and higher-performance NumPy ufuncs for operations using arrays of geometries. Shapely is not primarily focused on data serialization formats or coordinate systems, but can be readily integrated with packages that are.

What is a ufunc?

A universal function (or ufunc for short) is a function that operates on n-dimensional arrays on an element-by-element fashion and supports array broadcasting. The underlying for loops are implemented in C to reduce the overhead of the Python interpreter.

Multithreading

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.

Usage

Here is the canonical example of building an approximately circular patch by buffering a point, using the scalar Geometry interface:

>>> from shapely import Point
>>> patch = Point(0.0, 0.0).buffer(10.0)
>>> patch
<POLYGON ((10 0, 9.952 -0.98, 9.808 -1.951, 9.569 -2.903, 9.239 -3.827, 8.81...>
>>> patch.area
313.6548490545941

Using the vectorized ufunc interface (instead of using a manual for loop), compare an array of points with a polygon:

>>> import shapely
>>> import numpy as np
>>> geoms = np.array([Point(0, 0), Point(1, 1), Point(2, 2)])
>>> polygon = shapely.box(0, 0, 2, 2)

>>> shapely.contains(polygon, geoms)
array([False,  True, False])

See the documentation for more examples and guidance: https://shapely.readthedocs.io

Requirements

Shapely 2.1 requires

Python >=3.10
GEOS >=3.9
NumPy >=1.21

Installing Shapely

We recommend installing Shapely using one of the available built distributions, for example using pip or conda:

$ pip install shapely
# or using conda
$ conda install shapely --channel conda-forge

See the installation documentation for more details and advanced installation instructions.

Integration

Shapely does not read or write data files, but it can serialize and deserialize 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)'

Shapely can also integrate with other Python GIS packages using GeoJSON-like dicts.

>>> import json
>>> from shapely.geometry import mapping, shape
>>> s = shape(json.loads('{"type": "Point", "coordinates": [0.0, 0.0]}'))
>>> s
<POINT (0 0)>
>>> print(json.dumps(mapping(s)))
{"type": "Point", "coordinates": [0.0, 0.0]}

Support

Questions about using Shapely may be asked on the GIS StackExchange using the “shapely” tag.

Bugs may be reported at https://github.com/shapely/shapely/issues.

Copyright & License

Shapely is licensed under BSD 3-Clause license. GEOS is available under the terms of GNU Lesser General Public License (LGPL) 2.1 at https://libgeos.org.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shapely-2.1.0rc1.tar.gz (314.9 kB view details)

Uploaded Mar 15, 2025 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

shapely-2.1.0rc1-cp313-cp313t-win_amd64.whl (1.7 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tWindows x86-64

shapely-2.1.0rc1-cp313-cp313t-win32.whl (1.5 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tWindows x86

shapely-2.1.0rc1-cp313-cp313t-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tmusllinux: musl 1.2+ x86-64

shapely-2.1.0rc1-cp313-cp313t-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tmusllinux: musl 1.2+ ARM64

shapely-2.1.0rc1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.1 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tmanylinux: glibc 2.17+ x86-64

shapely-2.1.0rc1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.0 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tmanylinux: glibc 2.17+ ARM64

shapely-2.1.0rc1-cp313-cp313t-macosx_11_0_arm64.whl (1.6 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tmacOS 11.0+ ARM64

shapely-2.1.0rc1-cp313-cp313t-macosx_10_13_x86_64.whl (1.8 MB view details)

Uploaded Mar 15, 2025 CPython 3.13tmacOS 10.13+ x86-64

shapely-2.1.0rc1-cp313-cp313-win_amd64.whl (1.7 MB view details)

Uploaded Mar 15, 2025 CPython 3.13Windows x86-64

shapely-2.1.0rc1-cp313-cp313-win32.whl (1.5 MB view details)

Uploaded Mar 15, 2025 CPython 3.13Windows x86

shapely-2.1.0rc1-cp313-cp313-musllinux_1_2_x86_64.whl (4.1 MB view details)

Uploaded Mar 15, 2025 CPython 3.13musllinux: musl 1.2+ x86-64

shapely-2.1.0rc1-cp313-cp313-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.13musllinux: musl 1.2+ ARM64

shapely-2.1.0rc1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.0 MB view details)

Uploaded Mar 15, 2025 CPython 3.13manylinux: glibc 2.17+ x86-64

shapely-2.1.0rc1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.13manylinux: glibc 2.17+ ARM64

shapely-2.1.0rc1-cp313-cp313-macosx_11_0_arm64.whl (1.6 MB view details)

Uploaded Mar 15, 2025 CPython 3.13macOS 11.0+ ARM64

shapely-2.1.0rc1-cp313-cp313-macosx_10_13_x86_64.whl (1.8 MB view details)

Uploaded Mar 15, 2025 CPython 3.13macOS 10.13+ x86-64

shapely-2.1.0rc1-cp312-cp312-win_amd64.whl (1.7 MB view details)

Uploaded Mar 15, 2025 CPython 3.12Windows x86-64

shapely-2.1.0rc1-cp312-cp312-win32.whl (1.5 MB view details)

Uploaded Mar 15, 2025 CPython 3.12Windows x86

shapely-2.1.0rc1-cp312-cp312-musllinux_1_2_x86_64.whl (4.1 MB view details)

Uploaded Mar 15, 2025 CPython 3.12musllinux: musl 1.2+ x86-64

shapely-2.1.0rc1-cp312-cp312-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.12musllinux: musl 1.2+ ARM64

shapely-2.1.0rc1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.1 MB view details)

Uploaded Mar 15, 2025 CPython 3.12manylinux: glibc 2.17+ x86-64

shapely-2.1.0rc1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.12manylinux: glibc 2.17+ ARM64

shapely-2.1.0rc1-cp312-cp312-macosx_11_0_arm64.whl (1.6 MB view details)

Uploaded Mar 15, 2025 CPython 3.12macOS 11.0+ ARM64

shapely-2.1.0rc1-cp312-cp312-macosx_10_13_x86_64.whl (1.8 MB view details)

Uploaded Mar 15, 2025 CPython 3.12macOS 10.13+ x86-64

shapely-2.1.0rc1-cp311-cp311-win_amd64.whl (1.7 MB view details)

Uploaded Mar 15, 2025 CPython 3.11Windows x86-64

shapely-2.1.0rc1-cp311-cp311-win32.whl (1.5 MB view details)

Uploaded Mar 15, 2025 CPython 3.11Windows x86

shapely-2.1.0rc1-cp311-cp311-musllinux_1_2_x86_64.whl (4.1 MB view details)

Uploaded Mar 15, 2025 CPython 3.11musllinux: musl 1.2+ x86-64

shapely-2.1.0rc1-cp311-cp311-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.11musllinux: musl 1.2+ ARM64

shapely-2.1.0rc1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.1 MB view details)

Uploaded Mar 15, 2025 CPython 3.11manylinux: glibc 2.17+ x86-64

shapely-2.1.0rc1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.0 MB view details)

Uploaded Mar 15, 2025 CPython 3.11manylinux: glibc 2.17+ ARM64

shapely-2.1.0rc1-cp311-cp311-macosx_11_0_arm64.whl (1.6 MB view details)

Uploaded Mar 15, 2025 CPython 3.11macOS 11.0+ ARM64

shapely-2.1.0rc1-cp311-cp311-macosx_10_9_x86_64.whl (1.8 MB view details)

Uploaded Mar 15, 2025 CPython 3.11macOS 10.9+ x86-64

shapely-2.1.0rc1-cp310-cp310-win_amd64.whl (1.7 MB view details)

Uploaded Mar 15, 2025 CPython 3.10Windows x86-64

shapely-2.1.0rc1-cp310-cp310-win32.whl (1.5 MB view details)

Uploaded Mar 15, 2025 CPython 3.10Windows x86

shapely-2.1.0rc1-cp310-cp310-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Mar 15, 2025 CPython 3.10musllinux: musl 1.2+ x86-64

shapely-2.1.0rc1-cp310-cp310-musllinux_1_2_aarch64.whl (3.8 MB view details)

Uploaded Mar 15, 2025 CPython 3.10musllinux: musl 1.2+ ARM64

shapely-2.1.0rc1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.0 MB view details)

Uploaded Mar 15, 2025 CPython 3.10manylinux: glibc 2.17+ x86-64

shapely-2.1.0rc1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.9 MB view details)

Uploaded Mar 15, 2025 CPython 3.10manylinux: glibc 2.17+ ARM64

shapely-2.1.0rc1-cp310-cp310-macosx_11_0_arm64.whl (1.6 MB view details)

Uploaded Mar 15, 2025 CPython 3.10macOS 11.0+ ARM64

shapely-2.1.0rc1-cp310-cp310-macosx_10_9_x86_64.whl (1.8 MB view details)

Uploaded Mar 15, 2025 CPython 3.10macOS 10.9+ x86-64

File details

Details for the file shapely-2.1.0rc1.tar.gz.

File metadata

Download URL: shapely-2.1.0rc1.tar.gz
Upload date: Mar 15, 2025
Size: 314.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for shapely-2.1.0rc1.tar.gz
Algorithm	Hash digest
SHA256	`32ffb7828d6ff944dea145a2859aa19b51bd943fc8632db5cc736ed38c381efb`
MD5	`cfc42e8f8b43940ce753fe778367d90b`
BLAKE2b-256	`cc80f7b927ce836cf4a2f9d34b9fd8d25a5a72fb55fd0d7a134d5dee8cbf69fc`

Algorithm	Hash digest
SHA256	`2c417407a5f6fad8aa9600177978045dc5f59bde281d5580f65ed7695eaa91af`
MD5	`5dabfca12599ca781f54ce7b9b53e612`
BLAKE2b-256	`87dc79c4af405b75f08ff730597d493afb3d8068c542b49d5871b8944aa46705`

Algorithm	Hash digest
SHA256	`5529af52a8cd8fbbe6481a895e17990da817c8a9f16205cba5310f0a836a218e`
MD5	`51b14a5784451100d30c1673040c6f73`
BLAKE2b-256	`11f02de5abe66bfe5f2d38630c0ea89d665615b3e39d350295590eb71c0a7ac4`

Algorithm	Hash digest
SHA256	`bd8cf6913f2d3e1eb9a242cd51e99a5a3267f42185632334ed6a695ef232a527`
MD5	`25fe4aa82137d4c58c8f24ae74aad0fc`
BLAKE2b-256	`ea8ee1e74e3a145366438c9fe4990861b4e7d17e90edec14ef4107fea4059892`

Algorithm	Hash digest
SHA256	`3b38fd7d75d019898c008cc6693183286e89523fd984ab29a82cc544fc289830`
MD5	`0932bebd0d38b0f9ac01f89a9c4ab5d1`
BLAKE2b-256	`d56f39dac5c5cf4160b7c4b4d6324a5c30c3023abb972200a5bdd5ff9aa2afd0`

Algorithm	Hash digest
SHA256	`f5a102a1d5871a47e718ce2d433eb40ef4a5601cdfd2c416d15812a796567fe3`
MD5	`295a95bce243318fd61e752e4e1a08cb`
BLAKE2b-256	`9c41455422045f5a4217c031a5f32b5d591f7a618a200451fa93419557aa0ae1`

Algorithm	Hash digest
SHA256	`18312498ba79a71887874edf1dba9c8562a1d69050ac208313d4e8d7d0986c6f`
MD5	`f945c373e3151d8f967aeeceb20abc1f`
BLAKE2b-256	`f35819a1957ba4b861aa1794554ef234815cee4393833702773711c4dd883aae`

Algorithm	Hash digest
SHA256	`03040e30fd749fb297f30684170343fb5a8c8d042a682ce1298e8fca332d4d25`
MD5	`4f2066e17f85cf56e103a9a8142fc9b6`
BLAKE2b-256	`340f0123baac6e9ac4376154ad0a02f149e11dc6488ec8bd7a59b156eb5ecdc7`

Algorithm	Hash digest
SHA256	`2d14ea683510cd288afb20411693f00212131fbc8e061bb442b87edad8346452`
MD5	`a92533a7da61c6a8e0737d147ecd365d`
BLAKE2b-256	`f02513be12ee5bcdba3b1fcc0dc145587cf990f9ce84e929d4a742dd6bca141b`

Algorithm	Hash digest
SHA256	`cf9adf403037d8f4cf23121b342d9a99a48cdf69b70ff014e851495db94042e1`
MD5	`a37dcfc38ed105ad1965b1f3f9c95a59`
BLAKE2b-256	`5df06c0c5242287ef24dadeac764e41a444ea3451ed5263eb2a03e1c3b6fab6f`

Algorithm	Hash digest
SHA256	`5406d8d1c7684f67b3817705fb4449d3e80fe842850124205748ba3e59b48c6d`
MD5	`55c2f0db995e3c4d8d80547d2d369051`
BLAKE2b-256	`4ae397186f561ba19b1748d6cbdecb3c3abe1311b84fae1cc78e4e1b0af3f014`

Algorithm	Hash digest
SHA256	`26d9265798db1a9b5b649a443c3ae0fffec0c9d1cf312a7f8c7a56d5b6bbde12`
MD5	`01acfcca78c1ad14c2b83ee0239b8f21`
BLAKE2b-256	`a2a8d5aedd922b50a09052dae8db764bab358a1fafeea552812245184242849c`

Algorithm	Hash digest
SHA256	`87cc8da162fb4f138af2c7a0efbf181f8f756b7f26e7bd6e2d5b72368ebbe949`
MD5	`56ab3f85564062d50bb505b970454b08`
BLAKE2b-256	`6e884e1b48860dd2337641ffbafd676e7715a4a915aba5657b83772f3ed10f55`

Algorithm	Hash digest
SHA256	`7d903d61c0d2b2af81ad53670e2074ace3ebdb4adc150dc160cc772f40b13360`
MD5	`ed0bbacbd867d50219d0434c81385c87`
BLAKE2b-256	`1dd6354968597839ba9a1c70d5564ff762845e982bb3bd3bb8959c723bdb7518`

Algorithm	Hash digest
SHA256	`49114291a20e1a368b4a5929a485cbbcbc742f0d099fe0a34eded6a76f13eeb6`
MD5	`89fbb5ea30ef2c43a0911353fd1ff620`
BLAKE2b-256	`9dc573e28511969de17330bec67d1d33ad81aa53a0ac1daf810793a01d51ac12`

Algorithm	Hash digest
SHA256	`05029b8fc9b6eff2ba7e016cee1e4522dc219c620983b5f599056820fbc568cc`
MD5	`99aafc4dc5f87a93f5be5b4303df2bdd`
BLAKE2b-256	`a43d3498f0858e24ef361ba10cc2aed899a2ad40282450c17b8977d4addd6c15`

Algorithm	Hash digest
SHA256	`cf2c67974175dec527ac7231bca0b273f981660b6e449ddbc774efb60238b750`
MD5	`f90ab587cfbf3c50562acb7245888524`
BLAKE2b-256	`cf08e23a9851f28e69203db3edb0658dd8f49dcb24222728031aa61c3ea24bfd`

Algorithm	Hash digest
SHA256	`766a71ca2ccf98692c9a952eb63007d380d109b95bd511353af53a34929e6ae7`
MD5	`0b68701f3582d94f1a1e924e368ed035`
BLAKE2b-256	`e08ea460e77757aa2139bda2c484091153d05a155422dca74024df3021cc6a69`

Algorithm	Hash digest
SHA256	`1189e1d12200dbae42e4671b0a1991a382141b0b9a80cc018457473216ea2440`
MD5	`0334fdc3290ebc8006c7d808e4de826d`
BLAKE2b-256	`09b34ceb3603ce64344115b1c758784c5d65a876930e4cf50994d60537f00df0`

Algorithm	Hash digest
SHA256	`24ae8067b8947d6778a0a005f666f1f1d17c21120154ec7d90dc6ab80a274eb8`
MD5	`15494c4a91a063972cb06b8cf5f8b1a9`
BLAKE2b-256	`88a245b98c3c4fbcf9516b4a9ebb03b4d75378d1a6e0c7b3d037310636433e51`

Algorithm	Hash digest
SHA256	`1b9fab7bd02dbc4b604f3613083e6b3762c7d5532c69fd90b73a34d63bf29863`
MD5	`0f3d855c1455f9d1b7ca8b0c53dc3b81`
BLAKE2b-256	`9d08da21bd24381b131d40155ca16e6b971d600c00a21edc117eb3513e0c4ee9`

shapely 2.1.0rc1

What is a ufunc?

Multithreading

Usage

Requirements

Installing Shapely

Integration

Support

Copyright & License

Project links

Key dates

3 maintainers

Credits

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

Algorithm	Hash digest
SHA256	`c6ff88c117fe61d8abcf67f94da5d10ce508d9af819cf4c739ab94323217e649`
MD5	`48485fe929835d82c9b6306e84a9c7e5`
BLAKE2b-256	`1dd9836519963a2eed14a400e657ad1a088f2d111b93367b6fd1b03330b3654d`

Algorithm	Hash digest
SHA256	`18908498284a3aa287182fca6432e75ffcc210f724661207f8f927465f0bc361`
MD5	`105c648cce99cfe98a35509133b75686`
BLAKE2b-256	`b4b710b9573af0f6b5be72c924fbfc4b0eed43819254d9f34165d5b9d2619b29`

Algorithm	Hash digest
SHA256	`c01254b569b84a7e95afd3036ca2ceb3498f8a6e1b32954f1ed517c723c497d2`
MD5	`8bea564076a1c3569b83d235f4d9e4f2`
BLAKE2b-256	`292a764a1194e56302f1ffc870b260999738e630e5c2e9361ad85dec80abad98`

Algorithm	Hash digest
SHA256	`a6cac088e45e15bc80021adc0d6b2f6fbf6ffed39cd000a7f6c2564d6be5945d`
MD5	`cd8bbe85624e5986326b60a081869497`
BLAKE2b-256	`47ee8ce88921899551995aeb905107f6cfa8c72d6196ead4531ad05f1779a74b`

Algorithm	Hash digest
SHA256	`af925384fcf5bebfb43593f49bc2e05c0521d19b511c14b7a0c6aebe7420648d`
MD5	`8312442ec46475604862afa41c465eb3`
BLAKE2b-256	`62856a74db1651df593a126198bed6e6de71fd6d3b0f2f04c33b928cd721a481`

Algorithm	Hash digest
SHA256	`f98d0d5e99067fdacb4b336e9adc316045f7b2f4f7ed1f0a13c974b83901a424`
MD5	`33268ac55957ec4c2c6befac3e534498`
BLAKE2b-256	`c474d30de161b1c7ec7b05f56e40ffba4f38434295922d725c068b4fe941924e`

Algorithm	Hash digest
SHA256	`9a8813b9645ac08b123576ed87f079ee773f4068627ad8bef6c57edc789624a9`
MD5	`9e08928d26b019a0e3dec27f29d77d43`
BLAKE2b-256	`7de7b91ee863998e8dffafc1f346b10e4eebaa38a5d6497814b3b15d010408bf`

Algorithm	Hash digest
SHA256	`08e9d3465bf60149ed1d333d94af7fe56cb868d840cda98f1d5ca4339e26a6b7`
MD5	`aad85d9f50c2713913f083b347b3240d`
BLAKE2b-256	`7bd599014e20046b6631525cf1f0f9494badb706e72b143dc9e926b2ea53c6cf`

Algorithm	Hash digest
SHA256	`a37a053f91ad453ff2f04fc735e28b71355c96fc6840131ade61527c4ea06146`
MD5	`98b25dfaaca452af6526ab7ddd5e2a07`
BLAKE2b-256	`04a7480430212cfe0f070cfdb319b8f1326a1789f6f0247685ebf30f820f0a68`

Algorithm	Hash digest
SHA256	`532abf34c4e5d641c45337d96950d7200ed07c0db9b54fcaac3d6ed28ae26654`
MD5	`d3941199c97e86329310e8618d834b8f`
BLAKE2b-256	`dc56b53ed3d582f01ec141cea8c607dcad05661b15b26d249ef82f104795a413`