shapely是基于笛卡尔坐标的几何对象操作和分析Python库。底层基于GEOS和JTS库。shapely无法读取和写数据文件，但可以基于应用广泛的一些格式和协议进行序列化(serialize)和去序列化(deserialize)操作。而且shapely不关注数据格式和坐标系统，但shapely的整合性很强，可以和GIS之类的工具协同工作。这种黏性类似python。

安装

基于构建的发行版

windows

Mac OS和Linux

  • pip install shapely，如果需要针对向量化加速版本可通过pip install shapely[vectorized]安装
  • 通过系统包管理器，比如 apt，yum 和 Homebrew等。
  • 也可以通过Canopy和Anaconda等Python发行版工具安装，比如Anaconda，conda install shapely

基于源码

当需要兼容基于GEOS的更多模块，或者想要使用不同的GEOS版本，可以基于源码进行安装：

1

pip install shapely --no-binary shapely

如果使用自定义GEOS版本进行安装时，可能需要指定geos-config程序的路径，

1

GEOS_CONFIG=/path/to/geos-config pip install shapely

基本操作

  • 创建点

    1
2
3
4
5
6
7

    from shapely.geometry import Point
  
point = Point(0, 0) # Point((0, 0))
  
point.area    # 获取点的面积
point.length  # 获取点的长度
point.bounds  # 获取点的边界

  • 创建圆

    1
2
3
4

    In [20]: circle = Point(0, 0).buffer(10) # 创建以(0, 0)为圆心，10为半径的圆
  
In [25]: circle.area  # 获取创建的圆的面积
Out[25]: 313.6548490545939

    从上述结果可以看出，所创建的圆的面积小于 $\pi$ $r^2$，这是因为buffer方法默认参数resolution为16，resolution 的值越大圆越完整。

    1
2
3
4
5
6
7
8
9

    In [30]: circle = Point(0, 0).buffer(10, resolution=1000)
  
In [31]: circle.area
Out[31]: 314.15913616617644
      
In [32]: circle = Point(0, 0).buffer(10, resolution=1000000)
  
In [33]: circle.area
Out[33]: 314.1592653588436

  • 创建多边形

    1
2
3

    from shapely.geometry import Polygon
  
polygon = Polygon([(0, 1), (0, 2), (0, 3), (1, 1), (1, 2), (1, 3), (0, 3)])

    Note

    Polygon 函数仅能基于有序的点创建多边形，且点的集合必须要是闭合的。使用MultiPoint 函数创建，并使用 convex_hull 方法创建多边形。

    1
2
3
4

    from shapely.geometry import MultiPoint
  
coords = [(0, 1), (1, 2), (1, 4), (2, 0), (3, 2)]  # coords不一定要是闭合点集合
poly = MultiPoint(coords).convex_hull

集合操作

判断点是否在多边形

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

In [50]: p1 = Point(24.952242, 60.1696017)
In [51]: p2 = Point(24.976567, 60.1612500)
In [52]: coords = [(24.950899, 60.169158), (24.953492, 60.169158), (24.953510, 60.170104), (24.950958, 60.169990)]
In [53]: poly = Polygon(coords)

In [54]: poly.contains(p1)
Out[54]: True

In [55]: p1.within(poly)
Out[55]: True

In [56]: poly.contains(p2)
Out[56]: False

判断多边形的集合操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

In [57]: poly2 = Polygon([(23.2154, 59.1156), (24.83151, 59.41516), (25.11667, 60.311561), (24.16178, 60.13315)] )
    
In [58]: poly2.intersects(poly)
Out[58]: True
    
In [59]: poly2.contains(poly)
Out[59]: True
    
In [60]: poly.contains(poly2)
Out[60]: False
  • .contains：判断polygon1是否包含polygon2
  • .intersects：判断polygon1和polygon2是否重叠
  • .intersections ：返回两个polygon重叠的部分

参考链接：

  1. https://stackoverflow.com/questions/36399381/whats-the-fastest-way-of-checking-if-a-point-is-inside-a-polygon-in-python
  2. https://gis.stackexchange.com/questions/90055/finding-if-two-polygons-intersect-in-python
  3. https://automating-gis-processes.github.io/CSC18/lessons/L4/point-in-polygon.html