Validate Topology
Feature Description
During the collection and editing of spatial data, errors are inevitable. For instance, duplicate digitization of nodes/lines, gaps/intersections/non-closure between adjacent polygons may produce pseudo nodes, redundant vertices, dangling lines, or duplicate lines. These topological errors create inconsistencies between actual spatial relationships and collected data, impacting subsequent processing, analysis, and overall data quality. This tool performs topological validation to detect rule violations within or between point/line/region datasets, saving inspection results to designated output datasets.
Parameter Description
| Parameter | Description | Type |
|---|---|---|
| Source Dataset | The dataset to be validated for topology | DatasetVector |
| Topology Rules | Validation rules applied to the dataset | TopologyRule |
| Tolerances | Tolerance values in dataset units. Must be ≥0 (exceptions thrown if <0). Represents angular tolerance in degrees for acute angle rules | Double |
| Repair topology error | When enabled, automatically repairs detectable errors for supported rules (see table below) | Boolean |
| Area of Interest (Optional) |
Specifies validation area. Default processes entire dataset when empty | GeoRegion |
| Reference Dataset (Optional) |
Required for cross-dataset rules (e.g., "Points must lie on lines"). Not needed for single-dataset rules (e.g., "No overlapping lines") | DatasetVector |
| Target Datasource | Datasource storing result datasets | Datasource |
| Resulting dataset name | Name of the output dataset | String |
Automatically Repairable Topology Rules:
| Topology Rules | Repair Method |
|---|---|
| No pseudo nodes in line | Merges two connected lines at pseudo nodes |
| L/R has no redundant vertex | Removes redundant vertices from lines/polygon boundaries |
| Line not overlap line | Deletes overlapping segments from source line objects |
| No self overlap in line | Removes self-overlapping segments |
| No overlap in line | Deletes overlapping segments from one line |
| Vertex distance > tolerance | Snaps vertices within tolerance to a single node |
| Vertices must match | Adds matching vertices to line objects |
| Vertex exists at line intersect | Adds intersection vertices at line crossings |
| No overlap in region | Removes overlapping portions from one region |
| No identical points | Randomly retains one of coincident points |
Output
| Parameter | Description | Type |
|---|---|---|
| Source (Repaired) Dataset | Original dataset with repairs applied (if enabled). Unmodified dataset otherwise | DatasetVector |
| Validation Result Dataset | Dataset containing detected topological errors | DatasetVector |