From: Sandro Santilli Date: Tue, 3 Jan 2012 20:04:05 +0000 (+0000) Subject: Document TopoGeo_addLineString X-Git-Tag: 2.0.0alpha1~219 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1d655f2a29eeb42a372124dd0e1ddbf1af4d0ab8;p=postgis Document TopoGeo_addLineString git-svn-id: http://svn.osgeo.org/postgis/trunk@8656 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/extras_topology.xml b/doc/extras_topology.xml index 3f61a755a..631461343 100644 --- a/doc/extras_topology.xml +++ b/doc/extras_topology.xml @@ -1827,6 +1827,189 @@ SELECT ST_AsText(topology.ST_GetFaceGeometry('ma_topo', 1)) As facegeomwkt; Topology Processing + + + TopoGeo_AddPoint + + +Adds a point to an existing topology using a tolerance and possibly splitting an existing edge. + + + + + + + integer TopoGeo_AddNode + varchar toponame + geometry apoint + float8 tolerance + + + + + + Description + + +Adds a point to an existing topology and return its identifier. +The given point will snap to existing nodes or edges within given tolerance. +An existing edge may be split by the snapped point. + + + + Availability: 2.0.0 + + + + + + See Also + +, +, + + + + + + + + TopoGeo_AddLineString + + +Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges. + + + + + + + integer TopoGeo_AddLineString + varchar toponame + geometry aline + float8 tolerance + + + + + + Description + + +Adds a linestring to an existing topology and return a set of edge identifiers forming it up. +The given line will snap to existing nodes or edges within given tolerance. +Existing edges may be split by the line. + + + + Availability: 2.0.0 + + + + + + See Also + , + + + + + + Polygonize + Find and register all faces defined by topology edges + + + + + text Polygonize + varchar toponame + + + + + + Description + + Register all faces that can be built out a topology edge primitives. + The target topology is assumed to contain no self-intersecting edges. + Already known faces are recognized, so it is safe to call Polygonize multiple times on the same topology. + + + Availability: 2.0.0 + + + + + See Also + , + + + + + + AddNode + + Adds a point node to the node table in the specified topology schema and returns the nodeid of new node. If point already exists as node, the existing nodeid is returned. + + + + + + integer AddNode + varchar toponame + geometry apoint + boolean allowEdgeSplitting=false + boolean computeContainingFace=false + + + + + + Description + + +Adds a point node to the node table in the specified topology schema. +The function automatically adds start and end +points of an edge when called so not necessary to explicitly add nodes +of an edge. + + + +If any edge crossing the node is found either an exception is raised or +the edge is splitted, depending on the allowEdgeSplitting +parameter value. + + + +If computeContainingFace is true a newly added node would +get the correct containing face computed. + + + If the apoint geometry already exists as a node, the node is not added but the existing nodeid is returned. + + + Availability: 2.0.0 + + + + + Examples + SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 893816.5)', 26986) ) As nodeid; +-- result -- +nodeid +-------- + 4 + + + + + + + See Also + , + + + AddEdge @@ -1994,143 +2177,6 @@ faceid - - - TopoGeo_AddPoint - - -Adds a point to an existing topology using a tolerance and possibly splitting an existing edge. - - - - - - - integer TopoGeo_AddNode - varchar toponame - geometry apoint - float8 tolerance - - - - - - Description - - -Adds a point to an existing topology and return its identifier. -The given point will snap to existing nodes or edges within given tolerance. -An existing edge may be split by the snapped point. - - - - Availability: 2.0.0 - - - - - - See Also - , - - - - - - Polygonize - Find and register all faces defined by topology edges - - - - - text Polygonize - varchar toponame - - - - - - Description - - Register all faces that can be built out a topology edge primitives. - The target topology is assumed to contain no self-intersecting edges. - Already known faces are recognized, so it is safe to call Polygonize multiple times on the same topology. - - - Availability: 2.0.0 - - - - - See Also - , - - - - - - AddNode - - Adds a point node to the node table in the specified topology schema and returns the nodeid of new node. If point already exists as node, the existing nodeid is returned. - - - - - - integer AddNode - varchar toponame - geometry apoint - boolean allowEdgeSplitting=false - boolean computeContainingFace=false - - - - - - Description - - -Adds a point node to the node table in the specified topology schema. -The function automatically adds start and end -points of an edge when called so not necessary to explicitly add nodes -of an edge. - - - -If any edge crossing the node is found either an exception is raised or -the edge is splitted, depending on the allowEdgeSplitting -parameter value. - - - -If computeContainingFace is true a newly added node would -get the correct containing face computed. - - - If the apoint geometry already exists as a node, the node is not added but the existing nodeid is returned. - - - Availability: 2.0.0 - - - - - Examples - SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 893816.5)', 26986) ) As nodeid; --- result -- -nodeid --------- - 4 - - - - - - - See Also - , - -