TopoGeo_AddLineString
Name
TopoGeo_AddLineString — Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces.
Synopsis
SETOF bigint
TopoGeo_AddLineString
(
varchar
atopology
, geometry
aline
, float8
tolerance
, int
max_edges
)
;
Description
Adds a linestring to an existing topology and returns a set of signed edge identifiers forming it up (negative identifies mean the edge goes in the opposite direction of the input linestring).
The given line will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the line. New nodes and faces may be added, in addition to new edges.
The returned edge identifiers may be either existing edges or newly created edges as needed to fully represent the input line as closely as possible.
The number of newly created edges (either covering space previously
uncovered or resulting from split of existing edges) may be limited
by the
max_edges
parameter.
|
|
|
When adding many lines, the load order can have a large impact on performance because each call checks the line against topology elements already loaded. In bulk workflows, adding large closed or enclosing lines before smaller contained lines can avoid expensive later splits. For loading a collection in one call, see TopoGeo_LoadGeometry . |
|
|
|
Updating statistics about topologies being loaded via this function is up to caller, see maintaining statistics during topology editing and population . |
Availability: 2.0.0
Enhanced: 3.2.0 added support for returning signed identifier.
Enhanced: 3.7.0 added support for limiting the number of new edges created in the topology.
See Also
TopoGeo_AddPoint , TopoGeo_AddPolygon , TopoGeo_LoadGeometry , AddEdge , CreateTopology