geopandas.GeoSeries.covered_by#

GeoSeries.covered_by(other, align=True)#

返回一个 Seriesdtype('bool') 有价值的 True 对于完全覆盖的每个对齐的几何体 other

如果B的点不在A的外部,则称一个对象A覆盖另一个对象B。

该操作以1对1的行方式工作:

../../../_images/binary_op-01.svg

有关参考,请参阅https://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html。

参数
otherGeosSeries或几何对象

正在覆盖要检查的地理系列(元素级)或几何对象。

align布尔值(默认为True)

如果为True,则根据其索引自动对齐GeoSeries。如果为False,则保留元素的顺序。

退货
系列(布尔图)

注意事项

This method works in a row-wise manner. It does not check if an element of one GeoSeries is covered_by any element of the other one.

示例

>>> from shapely.geometry import Polygon, LineString, Point
>>> s = 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),
...     ],
... )
>>> s2 = 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),
...     ],
...     index=range(1, 5),
... )
>>> s
0    POLYGON ((0.50000 0.50000, 1.50000 0.50000, 1....
1    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2....
2        LINESTRING (1.00000 1.00000, 1.50000 1.50000)
3                              POINT (0.00000 0.00000)
dtype: geometry
>>> s2
1    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2....
2    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
3        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
4                              POINT (0.00000 0.00000)
dtype: geometry

我们可以检查GeoSeries的每个几何体是否由单个几何体覆盖:

../../../_images/binary_op-03.svg
>>> poly = Polygon([(0, 0), (2, 0), (2, 2), (0, 2)])
>>> s.covered_by(poly)
0    True
1    True
2    True
3    True
dtype: bool

我们还可以逐行检查两个GeoSeries。上面的GeoSeries有不同的指数。我们可以基于索引值对齐这两个GeoSeries,并使用 align=True 或忽略索引并根据元素的匹配顺序使用 align=False

../../../_images/binary_op-02.svg
>>> s.covered_by(s2, align=True)
0    False
1     True
2     True
3     True
4    False
dtype: bool
>>> s.covered_by(s2, align=False)
0     True
1    False
2     True
3     True
dtype: bool