geopandas.GeoSeries.最短线#

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

返回两个几何形状之间的最短两点线。

结果线由两个点组成，表示几何对之间的最近点。该线始终从第一个几何体 a 开始，并在第二个几何体 b 结束。线的端点不一定是输入几何体 a 和 b 的现有顶点，也可以是线段上的一个点。

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

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),
...     ],
... )
>>> 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

我们还可以计算每个几何图形与单个 shapely 几何图形的交集：

>>> p = Point(3, 3)
>>> s.shortest_line(p)
0    LINESTRING (2 2, 3 3)
1    LINESTRING (2 2, 3 3)
2    LINESTRING (2 2, 3 3)
3    LINESTRING (1 1, 3 3)
4    LINESTRING (0 1, 3 3)
dtype: geometry

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

>>> s2 = geopandas.GeoSeries(
...     [
...         Polygon([(0.5, 0.5), (1.5, 0.5), (1.5, 1.5), (0.5, 1.5)]),
...         Point(3, 1),
...         LineString([(1, 0), (2, 0)]),
...         Point(10, 15),
...         Point(0, 1),
...     ],
...     index=range(1, 6),
... )

>>> s.shortest_line(s2, align=True)
0                             None
1    LINESTRING (0.5 0.5, 0.5 0.5)
2            LINESTRING (2 2, 3 1)
3            LINESTRING (2 0, 2 0)
4          LINESTRING (0 1, 10 15)
5                             None
dtype: geometry
>>>

>>> s.shortest_line(s2, align=False)
  LINESTRING (0.5 0.5, 0.5 0.5)
          LINESTRING (2 2, 3 1)
      LINESTRING (0.5 0.5, 1 0)
        LINESTRING (0 2, 10 15)
          LINESTRING (0 1, 0 1)
dtype: geometry

geopandas.GeoSeries.最短线#

这一页