geopandas.GeoSeries.relate

GeoSeries.relate(other, align=None)

返回几何体的 DE-9IM 交集矩阵

该操作以一对一的行方式进行：

Parameters:

otherBaseGeometry or GeoSeries

另一个几何体，用于计算DE-9IM交集矩阵。

alignbool | None (default None)

如果为真，则根据其索引自动对齐GeoSeries。 如果为假，则保留元素的顺序。 None默认为真。

Returns:

spatial_relations: Series of strings

DE-9IM交集矩阵描述了其他几何的空间关系。

示例

>>> from shapely.geometry import Polygon, LineString, Point
>>> s = geopandas.GeoSeries(
...     [
...         Polygon([(0, 0), (2, 2), (0, 2)]),
...         Polygon([(0, 0), (2, 2), (0, 2)]),
...         LineString([(0, 0), (2, 2)]),
...         LineString([(2, 0), (0, 2)]),
...         Point(0, 1),
...     ],
... )
>>> s2 = geopandas.GeoSeries(
...     [
...         Polygon([(0, 0), (1, 1), (0, 1)]),
...         LineString([(1, 0), (1, 3)]),
...         LineString([(2, 0), (0, 2)]),
...         Point(1, 1),
...         Point(0, 1),
...     ],
...     index=range(1, 6),
... )

>>> s
0    POLYGON ((0 0, 2 2, 0 2, 0 0))
1    POLYGON ((0 0, 2 2, 0 2, 0 0))
2             LINESTRING (0 0, 2 2)
3             LINESTRING (2 0, 0 2)
4                       POINT (0 1)
dtype: geometry

>>> s2
1    POLYGON ((0 0, 1 1, 0 1, 0 0))
2             LINESTRING (1 0, 1 3)
3             LINESTRING (2 0, 0 2)
4                       POINT (1 1)
5                       POINT (0 1)
dtype: geometry

我们可以将每个几何图形与一个单独的 shapely 几何图形关联起来：

>>> s.relate(Polygon([(0, 0), (1, 1), (0, 1)]))
0    212F11FF2
1    212F11FF2
2    F11F00212
3    F01FF0212
4    F0FFFF212
dtype: object

我们还可以逐行检查两个GeoSeries。 上面的GeoSeries具有不同的索引。我们可以基于索引值对两个GeoSeries进行对齐，并使用相同索引比较元素，使用 align=True，或者忽略索引并根据它们的匹配顺序比较元素，使用 align=False:

>>> s.relate(s2, align=True)
0         None
1    212F11FF2
2    0F1FF0102
3    1FFF0FFF2
4    FF0FFF0F2
5         None
dtype: object

>>> s.relate(s2, align=False)
0    212F11FF2
1    1F20F1102
2    0F1FF0102
3    0F1FF0FF2
4    0FFFFFFF2
dtype: object