geopandas.GeoSeries.geom_equals#

GeoSeries.geom_equals(other, align=None)[来源]#

返回一个 Series,其 dtype('bool') 值为 True,对应于每个与 other 对齐的几何图形。

一个对象被称为与 other 相等,如果它的集合论 边界内部外部 与其他对象的相符。

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

../../../_images/binary_op-01.svg
Parameters:
otherGeoSeries or geometric object

要测试相等性的GeoSeries(逐元素)或几何对象。

alignbool | None (default None)

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

Returns:
Series (bool)

笔记

该方法以行的方式工作。它不检查一组GeoSeries的元素是否等于另一组中任何元素。

示例

>>> 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), (2, 2), (0, 2)]),
...         Polygon([(0, 0), (1, 2), (0, 2)]),
...         Point(0, 1),
...         LineString([(0, 0), (0, 2)]),
...     ],
...     index=range(1, 5),
... )
>>> s
0    POLYGON ((0 0, 2 2, 0 2, 0 0))
1    POLYGON ((0 0, 1 2, 0 2, 0 0))
2             LINESTRING (0 0, 0 2)
3                       POINT (0 1)
dtype: geometry
>>> s2
1    POLYGON ((0 0, 2 2, 0 2, 0 0))
2    POLYGON ((0 0, 1 2, 0 2, 0 0))
3                       POINT (0 1)
4             LINESTRING (0 0, 0 2)
dtype: geometry

我们可以检查每个GeoSeries的几何体是否包含一个单独的几何体:

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

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

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