geopandas.GeoSeries.within#
- GeoSeries.within(other, align=True)#
返回一个
Series
的dtype('bool')
有价值的True
对于中的每个对齐几何图形 other 。一个物体被称为在 other 如果它的至少一个点位于 interior 并且没有任何点位于 exterior 另一个人的。如果任一对象为空,则此操作返回
False
。这是与
contains()
从这个意义上讲,表达a.within(b) == b.contains(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 is
within
any element of the other one.示例
>>> from shapely.geometry import Polygon, LineString, Point >>> s = geopandas.GeoSeries( ... [ ... Polygon([(0, 0), (2, 2), (0, 2)]), ... Polygon([(0, 0), (1, 2), (0, 2)]), ... LineString([(0, 0), (0, 2)]), ... Point(0, 1), ... ], ... ) >>> s2 = geopandas.GeoSeries( ... [ ... Polygon([(0, 0), (1, 1), (0, 1)]), ... LineString([(0, 0), (0, 2)]), ... LineString([(0, 0), (0, 1)]), ... Point(0, 1), ... ], ... index=range(1, 5), ... )
>>> s 0 POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0.... 1 POLYGON ((0.00000 0.00000, 1.00000 2.00000, 0.... 2 LINESTRING (0.00000 0.00000, 0.00000 2.00000) 3 POINT (0.00000 1.00000) dtype: geometry
>>> s2 1 POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0.... 2 LINESTRING (0.00000 0.00000, 0.00000 2.00000) 3 LINESTRING (0.00000 0.00000, 0.00000 1.00000) 4 POINT (0.00000 1.00000) dtype: geometry
我们可以检查GeoSeries的每个几何体是否位于单个几何体中:
>>> polygon = Polygon([(0, 0), (2, 2), (0, 2)]) >>> s.within(polygon) 0 True 1 True 2 False 3 False dtype: bool
我们还可以逐行检查两个GeoSeries。上面的GeoSeries有不同的指数。我们可以基于索引值对齐这两个GeoSeries,并使用
align=True
或忽略索引并根据元素的匹配顺序使用align=False
:>>> s2.within(s) 0 False 1 False 2 True 3 False 4 False dtype: bool
>>> s2.within(s, align=False) 1 True 2 False 3 True 4 True dtype: bool