Skip to content

Commit 0ae99dd

Browse files
authored
Harmonize Check/Fix geometry algorithms description (#10274)
Backports #10262
2 parents bd47cd8 + 89d47c1 commit 0ae99dd

File tree

2 files changed

+106
-49
lines changed

2 files changed

+106
-49
lines changed

docs/user_manual/processing_algs/qgis/checkgeometry.rst

Lines changed: 51 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@ resulting in an endpoint without a proper connection.
2323
.. figure:: img/check_geometry_dangleendlines.png
2424
:align: center
2525

26-
Errors for dangle-end lines are reported on line features, and entire features with dangling ends are highlighted in red for clarity.
26+
Errors for dangle-end lines are reported on line features,
27+
and entire features with dangling ends are highlighted in red for clarity.
2728

2829
Parameters
2930
..........
@@ -110,21 +111,23 @@ Outputs
110111
- ``ERRORS``
111112
- [vector: point]
112113
- Output point layer representing the error locations and information.
113-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
114-
114+
The output layer contains the following fields:
115+
115116
- ``gc_layerid``: the ID of the input layer.
116117
- ``gc_layername``: the name of the input layer.
117118
- ``gc_partidx``: the index of the feature's geometry part containing the dangle-end.
118119
- ``gc_ringidx``: the index of the feature's geometry ring containing the dangle-end.
119-
- ``gc_vertidx``: the vertex index of the dangle-end in the feature.
120+
- ``gc_vertidx``: the vertex index of the dangle-end in the feature's geometry ring.
120121
- ``gc_errorx``: the x coordinate of the dangle-end.
121122
- ``gc_errory``: the y coordinate of the dangle-end.
122123
- ``gc_error``
124+
- ``UNIQUE_ID`` field: the unique ID of the input feature with the dangle-end.
123125
* - **Dangle-end features**
124126
- ``OUTPUT``
125127
- [vector: line]
126128
- Output line layer containing the input dangle-end features.
127129
If no dangle-end features are found, the output layer will be empty.
130+
Available fields are the same as in the ``ERRORS`` output.
128131

129132
Python code
130133
...........
@@ -230,8 +233,8 @@ Outputs
230233
- ``ERRORS``
231234
- [vector: point]
232235
- Output point layer representing the error locations and information.
233-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
234-
236+
The output layer contains the following fields:
237+
235238
- ``gc_layerid``: the ID of the input layer.
236239
- ``gc_layername``: the name of the input layer.
237240
- ``gc_partidx``
@@ -240,6 +243,7 @@ Outputs
240243
- ``gc_errorx``: the x coordinate of the centroid of the duplicate geometry.
241244
- ``gc_errory``: the y coordinate of the centroid of the duplicate geometry.
242245
- ``gc_error``: the indices of the duplicate geometry (all except the highest index).
246+
- ``UNIQUE_ID`` field: the unique ID of the input feature that is a duplicate.
243247
* - **Duplicate geometries**
244248
- ``OUTPUT``
245249
- [vector: same as input]
@@ -352,16 +356,17 @@ Outputs
352356
- ``ERRORS``
353357
- [vector: point]
354358
- Output point layer representing the error locations and information.
355-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
359+
The output layer contains the following fields:
356360

357361
- ``gc_layerid``: the ID of the input layer.
358362
- ``gc_layername``: the name of the input layer.
359363
- ``gc_partidx``: the index of the feature's geometry part containing the duplicate vertex.
360364
- ``gc_ringidx``: the index of the feature's geometry ring containing the duplicate vertex.
361-
- ``gc_vertidx``
365+
- ``gc_vertidx``: the index of the duplicate vertex in the feature's geometry ring.
362366
- ``gc_errorx``: the x coordinate of the duplicate vertex.
363367
- ``gc_errory``: the y coordinate of the duplicate vertex.
364368
- ``gc_error``
369+
- ``UNIQUE_ID`` field: the unique ID of the input feature that has duplicate vertices.
365370
* - **Duplicated vertices features**
366371
- ``OUTPUT``
367372
- [vector: same as input]
@@ -483,8 +488,8 @@ Outputs
483488
- ``ERRORS``
484489
- [vector: point]
485490
- Output point layer representing the error locations and information.
486-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
487-
491+
The output layer contains the following fields:
492+
488493
- ``gc_layerid``: the ID of the input layer.
489494
- ``gc_layername``: the name of the input layer.
490495
- ``gc_partidx``
@@ -493,6 +498,7 @@ Outputs
493498
- ``gc_errorx``: the x coordinate of the centroid of the contained feature.
494499
- ``gc_errory``: the y coordinate of the centroid of the contained feature.
495500
- ``gc_error``: the layer name and feature ID of a polygon that contains the feature.
501+
- ``UNIQUE_ID`` field: the unique ID of the input feature that is contained within another.
496502
* - **Contained features**
497503
- ``OUTPUT``
498504
- [vector: same as input]
@@ -608,8 +614,8 @@ Outputs
608614
- ``ERRORS``
609615
- [vector: point]
610616
- Output point layer representing the error locations and information.
611-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
612-
617+
The output layer contains the following fields:
618+
613619
- ``gc_layerid``: the ID of the input layer.
614620
- ``gc_layername``: the name of the input layer.
615621
- ``gc_partidx``: the index of the feature's geometry part containing the hole.
@@ -618,6 +624,7 @@ Outputs
618624
- ``gc_errorx``: the x coordinate of the centroid of the hole.
619625
- ``gc_errory``: the y coordinate of the centroid of the hole.
620626
- ``gc_error``
627+
- ``UNIQUE_ID`` field: the unique ID of the input feature that has a hole.
621628
* - **Polygon with holes**
622629
- ``OUTPUT``
623630
- [vector: polygon]
@@ -730,8 +737,7 @@ Outputs
730737
- ``ERRORS``
731738
- [vector: point]
732739
- Output point layer representing the error locations and information.
733-
Other than the ``UNIQUE_ID`` field referring to an intersecting input feature,
734-
the output layer also contains the following fields:
740+
The output layer contains the following fields:
735741

736742
- ``gc_layerid``: the ID of the input layer.
737743
- ``gc_layername``: the name of the input layer.
@@ -740,13 +746,14 @@ Outputs
740746
- ``gc_vertidx``
741747
- ``gc_errorx``: the x coordinate of the intersection point.
742748
- ``gc_errory``: the y coordinate of the intersection point.
749+
- ``UNIQUE_ID`` field: the unique ID of an intersecting input feature.
743750
- ``gc_error``: the layer name and index of the other intersecting feature.
744751
* - **Intersecting feature**
745752
- ``OUTPUT``
746753
- [vector: line]
747754
- Output layer containing, for each identified intersection, the feature (with same ``UNIQUE_ID`` value) it belongs to.
748755
If no intersections are found, the output layer will be empty.
749-
Additional fields are available (see ``ERRORS`` output).
756+
Available fields are the same as in the ``ERRORS`` output.
750757

751758
Python code
752759
...........
@@ -857,7 +864,7 @@ Outputs
857864
- ``ERRORS``
858865
- [vector: point]
859866
- Output point layer representing the error location and information.
860-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
867+
The output layer contains the following fields:
861868

862869
- ``gc_layerid``: the ID of the input layer.
863870
- ``gc_layername``: the name of the input layer.
@@ -866,13 +873,14 @@ Outputs
866873
- ``gc_vertidx``
867874
- ``gc_errorx``: the x coordinate of the intersection point.
868875
- ``gc_errory``: the y coordinate of the intersection point.
876+
- ``UNIQUE_ID`` field: the unique ID of the intersecting input feature.
869877
- ``gc_error``: the index of the check layer where the intersection occurs.
870878
* - **Line intersecting other layer features**
871879
- ``OUTPUT``
872880
- [vector: line]
873881
- Output layer containing, for each identified intersection, the input feature it belongs to.
874882
If no intersections are found, the output layer will be empty.
875-
Additional fields are available (see ``ERRORS`` output).
883+
Available fields are the same as in the ``ERRORS`` output.
876884

877885
Python code
878886
...........
@@ -921,7 +929,7 @@ Basic parameters
921929
- ``UNIQUE_ID``
922930
- [tablefield: any]
923931
- Field storing unique values for feature identification.
924-
* - **Min overlap area**
932+
* - **Minimum overlap area**
925933
- ``MIN_OVERLAP_AREA``
926934
- [numeric: double]
927935
- Minimum area of the overlap to be reported as an error.
@@ -988,19 +996,20 @@ Outputs
988996
- ``ERRORS``
989997
- [vector: point]
990998
- Output point layer representing the error locations and information.
991-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
992-
999+
The output layer contains the following fields:
1000+
9931001
- ``gc_layerid``: the ID of the input layer.
9941002
- ``gc_layername``: the name of the input layer.
9951003
- ``gc_errorx``: the x coordinate of the centroid of the overlapping area.
9961004
- ``gc_errory``: the y coordinate of the centroid of the overlapping area.
9971005
- ``gc_error``: the area of the overlapping geometry.
998-
- ``gc_overlap_feature_{unique_id}``: the ``UNIQUE_ID`` field value for the overlapping feature.
1006+
- ``UNIQUE_ID`` field: the unique ID of an overlapped input feature.
1007+
- ``gc_overlap_feature_{unique_id}``: the ``UNIQUE_ID`` field value for the other overlapping feature.
9991008
* - **Overlap features**
10001009
- ``OUTPUT``
10011010
- [vector: polygon]
10021011
- Output layer containing the overlapping areas.
1003-
Additional fields are available (see ``ERRORS`` output).
1012+
Available fields are the same as in the ``ERRORS`` output.
10041013

10051014
Python code
10061015
...........
@@ -1111,8 +1120,8 @@ Outputs
11111120
- ``ERRORS``
11121121
- [vector: point]
11131122
- Output point layer representing the error locations and information.
1114-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
1115-
1123+
The output layer contains the following fields:
1124+
11161125
- ``gc_layerid``: the ID of the input layer.
11171126
- ``gc_layername``: the name of the input layer.
11181127
- ``gc_partidx``: the index of the feature's geometry part where the self-intersection occurs.
@@ -1123,6 +1132,7 @@ Outputs
11231132
- ``gc_error``
11241133
- ``gc_segment_1``: the index of the first segment involved in the intersection.
11251134
- ``gc_segment_2``: the index of the second segment involved in the intersection.
1135+
- ``UNIQUE_ID`` field: the unique ID of the self-intersecting input feature.
11261136
* - **Self-intersecting features**
11271137
- ``OUTPUT``
11281138
- [vector: line, polygon]
@@ -1231,10 +1241,18 @@ Outputs
12311241
* - **Small angle errors**
12321242
- ``ERRORS``
12331243
- [vector: point]
1234-
- Output point layer representing the error locations and information
1235-
(the ID and name of the input layer, the ID, geometry part,
1236-
ring and vertex index of the erroneous feature,
1237-
x and y coordinates of the error and the value of the erroneous angle).
1244+
- Output point layer representing the error locations and information.
1245+
The output layer contains the following fields:
1246+
1247+
- ``gc_layerid``: the ID of the input layer.
1248+
- ``gc_layername``: the name of the input layer.
1249+
- ``gc_partidx``: the index of the feature's geometry part containing the small angle.
1250+
- ``gc_ringidx``: the index of the feature's geometry ring containing the small angle.
1251+
- ``gc_vertidx``: the index of the vertex with the small angle in the feature's geometry ring.
1252+
- ``gc_errorx``: the x coordinate of the vertex with the small angle.
1253+
- ``gc_errory``: the y coordinate of the vertex with the small angle.
1254+
- ``gc_error``: the error angle value.
1255+
- ``UNIQUE_ID`` field: the unique ID of the input feature with the small angle.
12381256

12391257
Python code
12401258
...........
@@ -1353,21 +1371,22 @@ Outputs
13531371
- ``ERRORS``
13541372
- [vector: point]
13551373
- Output point layer representing the error locations and information.
1356-
Other than the ``UNIQUE_ID`` field, the output layer also contains the following fields:
1357-
1374+
The output layer contains the following fields:
1375+
13581376
- ``gc_layerid``: the ID of the input layer.
13591377
- ``gc_layername``: the name of the input layer.
13601378
- ``gc_partidx``: the index of the feature's geometry part containing the small segment.
13611379
- ``gc_ringidx``: the index of the feature's geometry ring containing the small segment.
1362-
- ``gc_vertidx``: the index of the end vertex of the small segment in the input geometry.
1380+
- ``gc_vertidx``: the index of the end vertex of the small segment in the feature's geometry ring.
13631381
- ``gc_errorx``: the x coordinate of the centroid of the small segment.
13641382
- ``gc_errory``: the y coordinate of the centroid of the small segment.
13651383
- ``gc_error``: the error segment length.
1384+
- ``UNIQUE_ID`` field: the unique ID of the input feature with the small segment.
13661385
* - **Short segments features**
13671386
- ``OUTPUT``
13681387
- [vector: same as input]
13691388
- Output layer containing, for each identified short segment, the feature it belongs to.
1370-
Additional fields are available (see ``ERRORS`` output).
1389+
Available fields are the same as in the ``ERRORS`` output.
13711390

13721391
Python code
13731392
...........

0 commit comments

Comments
 (0)