geopandas.GeoSeries.union#

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

返回一个 GeoSeries,该系列是每个对齐的几何体与 其他 中点的并集。

../../../_images/binary_geo-union.svg

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

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

要与之找到并集的GeoSeries(逐元素)或几何对象。

alignbool | None (default None)

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

Returns:
GeoSeries

示例

>>> from shapely.geometry import Polygon, LineString, Point
>>> s = geopandas.GeoSeries(
...     [
...         Polygon([(0, 0), (2, 2), (0, 2)]),
...         Polygon([(0, 0), (2, 2), (0, 2)]),
...         LineString([(0, 0), (2, 2)]),
...         LineString([(2, 0), (0, 2)]),
...         Point(0, 1),
...     ],
... )
>>> s2 = geopandas.GeoSeries(
...     [
...         Polygon([(0, 0), (1, 1), (0, 1)]),
...         LineString([(1, 0), (1, 3)]),
...         LineString([(2, 0), (0, 2)]),
...         Point(1, 1),
...         Point(0, 1),
...     ],
...     index=range(1, 6),
... )
>>> s
0    POLYGON ((0 0, 2 2, 0 2, 0 0))
1    POLYGON ((0 0, 2 2, 0 2, 0 0))
2             LINESTRING (0 0, 2 2)
3             LINESTRING (2 0, 0 2)
4                       POINT (0 1)
dtype: geometry
>>>
>>> s2
1    POLYGON ((0 0, 1 1, 0 1, 0 0))
2             LINESTRING (1 0, 1 3)
3             LINESTRING (2 0, 0 2)
4                       POINT (1 1)
5                       POINT (0 1)
dtype: geometry

我们可以将每个几何图形与一个单一的 shapely 几何图形进行并集:

../../../_images/binary_op-03.svg
>>> s.union(Polygon([(0, 0), (1, 1), (0, 1)]))
0             POLYGON ((0 0, 0 1, 0 2, 2 2, 1 1, 0 0))
1             POLYGON ((0 0, 0 1, 0 2, 2 2, 1 1, 0 0))
2    GEOMETRYCOLLECTION (POLYGON ((0 0, 0 1, 1 1, 0...
3    GEOMETRYCOLLECTION (POLYGON ((0 0, 0 1, 1 1, 0...
4                       POLYGON ((0 1, 1 1, 0 0, 0 1))
dtype: geometry

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

../../../_images/binary_op-02.svg
>>> s.union(s2, align=True)
0                                                 None
1             POLYGON ((0 0, 0 1, 0 2, 2 2, 1 1, 0 0))
2    MULTILINESTRING ((0 0, 1 1), (1 1, 2 2), (1 0,...
3                                LINESTRING (2 0, 0 2)
4                            MULTIPOINT ((0 1), (1 1))
5                                                 None
dtype: geometry
>>> s.union(s2, align=False)
0             POLYGON ((0 0, 0 1, 0 2, 2 2, 1 1, 0 0))
1    GEOMETRYCOLLECTION (POLYGON ((0 0, 0 2, 1 2, 2...
2    MULTILINESTRING ((0 0, 1 1), (1 1, 2 2), (2 0,...
3                                LINESTRING (2 0, 0 2)
4                                          POINT (0 1)
dtype: geometry