Skip to main content

Geospatial geometries, predicates, and operations

Project description

Shapely is a Python package for programming with geospatial geometries. It is based on GEOS (http://geos.refractions.net). Shapely 1.0 is ignorant about coordinate and reference systems. Projection responsibility is left to specific applications. For more information, see:

Shapely requires Python 2.4+. (I’ve also begun to port it to Python 3.0: http://zcologia.com/news/564/shapely-for-python-3-0/.)

Dependencies

  • libgeos_c (2.2.3, also reported to work with 3.0)

  • Python ctypes (standard in Python 2.5+)

Installation

Shapely can be installed from the Python package index:

$ sudo easy_install Shapely

with the setup script:

$ sudo python setup.py install

or by using the development buildout, which also provides libgeos_c:

$ svn co http://svn.gispython.org/svn/gispy/buildout/shapely.buildout/trunk shapely.buildout
$ cd shapely.buildout
$ python bootstrap.py
$ ./bin/buildout

Usage

Buffer a point:

>>> from shapely.geometry import Point
>>> point = Point(-106.0, 40.0) # longitude, latitude
>>> point.buffer(10.0)
<shapely.geometry.polygon.Polygon object at ...>

See Operations.txt and Predicates.txt under tests/ for more examples of the spatial operations and predicates provided by Shapely. Also see Point.txt, LineString.txt, etc for examples of the geometry APIs.

Numpy integration

All Shapely geometry instances provide the Numpy array interface:

>>> from numpy import asarray
>>> a = asarray(point)
>>> a.size
3
>>> a.shape
(2,)

Numpy arrays can also be adapted to Shapely points and linestrings:

>>> from shapely.geometry import asLineString
>>> a = array([[1.0, 2.0], [3.0, 4.0]])
>>> line = asLineString(a)
>>> line.wkt
'LINESTRING (1.0000000000000000 2.0000000000000000, 3.0000000000000000 4.0000000000000000)'

Python Geo Interface

Any object that provides the Python geo interface can be adapted to a Shapely geometry with the asShape factory:

>>> d = {"type": "Point", "coordinates": (0.0, 0.0)}
>>> from shapely.geometry import asShape
>>> shape = asShape(d)
>>> shape.geom_type
'Point'
>>> tuple(shape.coords)
((0.0, 0.0),)

>>> class GeoThing(object):
...     def __init__(self, d):
...         self.__geo_interface__ = d
>>> thing = GeoThing({"type": "Point", "coordinates": (0.0, 0.0)})
>>> shape = asShape(thing)
>>> shape.geom_type
'Point'
>>> tuple(shape.coords)
((0.0, 0.0),)

See http://trac.gispython.org/projects/PCL/wiki/PythonGeoInterface for more details on the interface.

Testing

Several of the modules have docstring doctests:

$ cd shapely
$ python point.py

There are also two test runners under tests/. test_doctests.py requires zope.testing. runalldoctests.py does not.

Support

For current information about this project, see the wiki.

If you have questions, please consider joining our community list:

http://trac.gispython.org/projects/PCL/wiki/CommunityList

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

Shapely-1.0b3.tar.gz (28.8 kB view details)

Uploaded Source

Built Distribution

Shapely-1.0b3-py2.4.egg (53.1 kB view details)

Uploaded Source

File details

Details for the file Shapely-1.0b3.tar.gz.

File metadata

  • Download URL: Shapely-1.0b3.tar.gz
  • Upload date:
  • Size: 28.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Shapely-1.0b3.tar.gz
Algorithm Hash digest
SHA256 3e2f1426ebe7bcb2c83b24939597f098d1cb98dadc47c74b0d195f07b2432137
MD5 7b4907658dedc5b2b3bd016c6a9b3663
BLAKE2b-256 d3a2a72bdf2a48428f80d78eda9b5c90709d6dc169a51e956cf185a538075809

See more details on using hashes here.

Provenance

File details

Details for the file Shapely-1.0b3-py2.4.egg.

File metadata

  • Download URL: Shapely-1.0b3-py2.4.egg
  • Upload date:
  • Size: 53.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Shapely-1.0b3-py2.4.egg
Algorithm Hash digest
SHA256 e44f6059cc1cf8df0b9c27cc005e8a00bdbb182b1c7c8509ee153aeb91950161
MD5 28d0ec3a69b9d1b39c986fea2eb4e6d4
BLAKE2b-256 1cd2ae5acee4bae2cce6c9f560f5a706c60fa32be70f372698bf6069c1c75983

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page