geopandas.GeoSeries.covers

GeoSeries.covers(other, align=None)

返回一个 Series，其 dtype('bool') 值为 True，用于每个完全覆盖 other 的对齐几何图形。

如果对象 A 没有 B 的任何点位于 A 的外部，则称对象 A 覆盖对象 B。 如果任一对象为空，则此操作返回 False。

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

请参见 https://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html 以获取参考。

Parameters:

otherGeoseries or geometric object

正在检查被覆盖的Geoseries（逐元素）或几何对象。

alignbool | None (default None)

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

Returns:

Series (bool)

另请参阅

GeoSeries.covered_by

GeoSeries.overlaps

笔记

此方法以逐行的方式工作。它不检查一个GeoSeries的元素是否covers另一个GeoSeries的任何元素。

示例

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

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

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

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

>>> poly = Polygon([(0, 0), (2, 0), (2, 2), (0, 2)])
>>> s.covers(poly)
0     True
1    False
2    False
3    False
dtype: bool

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

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

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