Linestring operations¶
- line_interpolate_point(line, distance, normalized=False, **kwargs)¶
Returns a point interpolated at given distance on a line.
- Parameters
- lineGeometry or array_like
For multilinestrings or geometrycollections, the first geometry is taken and the rest is ignored. This function raises a TypeError for non-linear geometries. For empty linear geometries, empty points are returned.
- distancefloat or array_like
Negative values measure distance from the end of the line. Out-of-range values will be clipped to the line endings.
- normalizedbool, default False
If True, the distance is a fraction of the total line length instead of the absolute distance.
- **kwargs
For other keyword-only arguments, see the NumPy ufunc docs.
Examples
>>> line = Geometry("LINESTRING(0 2, 0 10)") >>> line_interpolate_point(line, 2) <pygeos.Geometry POINT (0 4)> >>> line_interpolate_point(line, 100) <pygeos.Geometry POINT (0 10)> >>> line_interpolate_point(line, -2) <pygeos.Geometry POINT (0 8)> >>> line_interpolate_point(line, [0.25, -0.25], normalized=True).tolist() [<pygeos.Geometry POINT (0 4)>, <pygeos.Geometry POINT (0 8)>] >>> line_interpolate_point(Geometry("LINESTRING EMPTY"), 1) <pygeos.Geometry POINT EMPTY>
- line_locate_point(line, other, normalized=False, **kwargs)¶
Returns the distance to the line origin of given point.
If given point does not intersect with the line, the point will first be projected onto the line after which the distance is taken.
- Parameters
- lineGeometry or array_like
- pointGeometry or array_like
- normalizedbool, default False
If True, the distance is a fraction of the total line length instead of the absolute distance.
- **kwargs
For other keyword-only arguments, see the NumPy ufunc docs.
Examples
>>> line = Geometry("LINESTRING(0 2, 0 10)") >>> line_locate_point(line, Geometry("POINT(4 4)")) 2.0 >>> line_locate_point(line, Geometry("POINT(4 4)"), normalized=True) 0.25 >>> line_locate_point(line, Geometry("POINT(0 18)")) 8.0 >>> line_locate_point(Geometry("LINESTRING EMPTY"), Geometry("POINT(4 4)")) nan
- line_merge(line, **kwargs)¶
Returns (multi)linestrings formed by combining the lines in a multilinestrings.
- Parameters
- lineGeometry or array_like
- **kwargs
For other keyword-only arguments, see the NumPy ufunc docs.
Examples
>>> line_merge(Geometry("MULTILINESTRING((0 2, 0 10), (0 10, 5 10))")) <pygeos.Geometry LINESTRING (0 2, 0 10, 5 10)> >>> line_merge(Geometry("MULTILINESTRING((0 2, 0 10), (0 11, 5 10))")) <pygeos.Geometry MULTILINESTRING ((0 2, 0 10), (0 11, 5 10))> >>> line_merge(Geometry("LINESTRING EMPTY")) <pygeos.Geometry GEOMETRYCOLLECTION EMPTY>
Returns the shared paths between geom1 and geom2.
Both geometries should be linestrings or arrays of linestrings. A geometrycollection or array of geometrycollections is returned with two elements in each geometrycollection. The first element is a multilinestring containing shared paths with the same direction for both inputs. The second element is a multilinestring containing shared paths with the opposite direction for the two inputs.
- Parameters
- aGeometry or array_like
- bGeometry or array_like
- **kwargs
For other keyword-only arguments, see the NumPy ufunc docs.
Examples
>>> geom1 = Geometry("LINESTRING (0 0, 1 0, 1 1, 0 1, 0 0)") >>> geom2 = Geometry("LINESTRING (1 0, 2 0, 2 1, 1 1, 1 0)") >>> shared_paths(geom1, geom2) <pygeos.Geometry GEOMETRYCOLLECTION (MULTILINESTRING EMPTY, MULTILINESTRING ...>
- shortest_line(a, b, **kwargs)¶
Returns the shortest line between two geometries.
The resulting line consists of two points, representing the nearest points between the geometry pair. The line always starts in the first geometry a and ends in he second geometry b. The endpoints of the line will not necessarily be existing vertices of the input geometries a and b, but can also be a point along a line segment.
- Parameters
- aGeometry or array_like
- bGeometry or array_like
- **kwargs
For other keyword-only arguments, see the NumPy ufunc docs.
See also
prepare
improve performance by preparing
a
(the first argument) (for GEOS>=3.9)
Examples
>>> geom1 = Geometry("LINESTRING (0 0, 1 0, 1 1, 0 1, 0 0)") >>> geom2 = Geometry("LINESTRING (0 3, 3 0, 5 3)") >>> shortest_line(geom1, geom2) <pygeos.Geometry LINESTRING (1 1, 1.5 1.5)>