geopandas.GeoSeries.contains#
- GeoSeries.contains(other, align=True)#
返回一个
Series
的dtype('bool')
有价值的True
对于包含以下内容的每个对齐几何图形 other 。一个对象被称为包含 other 如果至少有一点 other 位于内陆,没有一点 other 存在于物体的外部。(因此,任何给定的多边形都不包含其自己的边界--没有位于内部的任何点。)如果任一对象为空,则此操作返回
False
。这是与
within()
从这个意义上讲,表达a.contains(b) == b.within(a)
始终计算为True
。该操作以1对1的行方式工作:
- 参数
- otherGeoSeries或几何对象
要测试其是否包含的GeoSeries(元素级)或几何对象。
- align布尔值(默认为True)
如果为True,则根据其索引自动对齐GeoSeries。如果为False,则保留元素的顺序。
- 退货
- 系列(布尔图)
注意事项
This method works in a row-wise manner. It does not check if an element of one GeoSeries
contains
any element of the other one.示例
>>> 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.00000 0.00000, 1.00000 1.00000, 0.... 1 LINESTRING (0.00000 0.00000, 0.00000 2.00000) 2 LINESTRING (0.00000 0.00000, 0.00000 1.00000) 3 POINT (0.00000 1.00000) dtype: geometry
>>> s2 1 POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0.... 2 POLYGON ((0.00000 0.00000, 1.00000 2.00000, 0.... 3 LINESTRING (0.00000 0.00000, 0.00000 2.00000) 4 POINT (0.00000 1.00000) 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