geopandas.GeoSeries.covers#
- GeoSeries.covers(other, align=True)#
返回一个
Series
的dtype('bool')
有价值的True
对于完全覆盖的每个对齐几何体 other 。如果一个对象A的外部没有B的点,则称该对象A覆盖了另一个对象B。如果其中一个对象为空,则此操作返回
False
。该操作以1对1的行方式工作:
有关参考,请参阅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
covers
any element of the other one.示例
>>> 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.00000 0.00000, 2.00000 0.00000, 2.... 1 POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0.... 2 LINESTRING (0.00000 0.00000, 2.00000 2.00000) 3 POINT (0.00000 0.00000) dtype: geometry
>>> s2 1 POLYGON ((0.50000 0.50000, 1.50000 0.50000, 1.... 2 POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2.... 3 LINESTRING (1.00000 1.00000, 1.50000 1.50000) 4 POINT (0.00000 0.00000) 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