geos_project: Linear referencing

In geos: Open Source Geometry Engine ('GEOS') R API

Linear referencing

Description

• geos_project() and geos_project_normalized() return the distance of point geom2 projected on geom1 from the origin of geom1, which must be a lineal geometry.

• geos_interpolate() performs an inverse operation, returning the point along geom representing the given distance from the origin along the geometry.

• ⁠_normalized()⁠ variants use a distance normalized to the geos_length() of the geometry.

Usage

geos_project(geom1, geom2)

geos_project_normalized(geom1, geom2)

geos_interpolate(geom, distance)

geos_interpolate_normalized(geom, distance_normalized)

Arguments

geom1, geom2	GEOS geometry vectors, recycled to a common length.
geom	A GEOS geometry vector
distance	Distance along the linestring to interpolate
distance_normalized	Distance along the linestring to interpolate relative to the length of the linestring.

Examples

geos_interpolate("LINESTRING (0 0, 1 1)", 1)
geos_interpolate_normalized("LINESTRING (0 0, 1 1)", 1)

geos_project("LINESTRING (0 0, 10 10)", "POINT (5 5)")
geos_project_normalized("LINESTRING (0 0, 10 10)", "POINT (5 5)")

geos documentation built on June 7, 2023, 6:04 p.m.