MakeTopologyPrecise
Prev  9.4. Topology and TopoGeometry Management  Next

Name

MakeTopologyPrecise — Snap topology vertices to precision grid.

Synopsis

void MakeTopologyPrecise(name toponame, geometry bbox, float8 gridSize);

Description

Snaps all vertices of a topology to the topology precision grid or to the grid whose size is specified with the gridSize parameter, optionally limiting the operation to the objects intersecting the area specified by the bbox parameter.

Using a gridSize larger than the smallest edge extent raises an exception rather than collapsing the edge into an empty geometry. This safeguards adjacent topological relationships by preventing precision snapping from removing primitives altogether.

[Note]

Snapping could make the topology invalid, so it is recommended to check the outcome of operation with ValidateTopology.

Availability: 3.6.0

Examples

SELECT topology.MakeTopologyPrecise(
    'city_data',
    gridSize => 2
);
 maketopologyprecise
---------------------

(1 row)