geopandas.GeoSeries.contains

GeoSeries.contains(other, align=None)

返回一个 Series 类型为 dtype('bool') 的值为 True 的系列，针对每个包含 other 的对齐几何。

如果一个对象包含other，那么至少有一个other的点位于对象的内部，且没有other的点位于对象的外部。 （因此，任何给定的多边形不包含它自己的边界 - 没有任何点位于内部。） 如果任一对象为空，则此操作返回False。

这是within()的逆运算，因为表达式a.contains(b) == b.within(a)总是计算为True。

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

Parameters:

otherGeoSeries or geometric object

要测试是否包含的 GeoSeries（逐元素）或几何对象。

alignbool | None (default None)

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

Returns:

Series (bool)

另请参阅

GeoSeries.contains_properly

GeoSeries.within

笔记

该方法以逐行的方式工作。它不检查一个GeoSeries的元素是否包含其他GeoSeries的任何元素。

示例

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

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

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

我们可以检查每个GeoSeries的几何体是否包含一个单独的几何体：

>>> point = Point(0, 1)
>>> s.contains(point)
0    False
1     True
2    False
3     True
dtype: bool

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

>>> s2.contains(s, align=True)
0    False
1    False
2    False
3     True
4    False
dtype: bool

>>> s2.contains(s, align=False)
1     True
2    False
3     True
4     True
dtype: bool