geopandas.GeoSeries.union#

GeoSeries.union(other, align=True)#

返回一个 GeoSeries 每个对齐的几何图形中的点的并集 other

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

该操作以1对1的行方式工作:

../../../_images/binary_op-01.svg
参数
otherGeosSeries或几何对象

要找到其并集的Geoseries(元素级)或几何对象。

align布尔值(默认为True)

如果为True,则根据其索引自动对齐GeoSeries。如果为False,则保留元素的顺序。

退货
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.00000 0.00000, 2.00000 2.00000, 0....
1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
4                              POINT (0.00000 1.00000)
dtype: geometry
>>> s2
1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
2        LINESTRING (1.00000 0.00000, 1.00000 3.00000)
3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
4                              POINT (1.00000 1.00000)
5                              POINT (0.00000 1.00000)
dtype: geometry

我们可以将每个几何体和单个形状整齐的几何体合并:

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

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

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