QGIS API Documentation 3.43.0-Master (e01d6d7c4c0)
qgsalgorithmcheckgeometryduplicatenodes.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmcheckgeometryduplicatenodes.cpp
3 ---------------------
4 begin : April 2025
5 copyright : (C) 2025 by Jacky Volpes
6 email : jacky dot volpes at oslandia dot com
7***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
22#include "qgspoint.h"
23#include "qgsvectorlayer.h"
25
27
28QString QgsGeometryCheckDuplicateNodesAlgorithm::name() const
29{
30 return QStringLiteral( "checkgeometryduplicatenodes" );
31}
32
33QString QgsGeometryCheckDuplicateNodesAlgorithm::displayName() const
34{
35 return QObject::tr( "Duplicated vertices" );
36}
37
38QString QgsGeometryCheckDuplicateNodesAlgorithm::shortDescription() const
39{
40 return QObject::tr( "Detects duplicated vertices in line and polygon geometries." );
41}
42
43QStringList QgsGeometryCheckDuplicateNodesAlgorithm::tags() const
44{
45 return QObject::tr( "check,geometry,duplicatenodes" ).split( ',' );
46}
47
48QString QgsGeometryCheckDuplicateNodesAlgorithm::group() const
49{
50 return QObject::tr( "Check geometry" );
51}
52
53QString QgsGeometryCheckDuplicateNodesAlgorithm::groupId() const
54{
55 return QStringLiteral( "checkgeometry" );
56}
57
58QString QgsGeometryCheckDuplicateNodesAlgorithm::shortHelpString() const
59{
60 return QObject::tr( "This algorithm checks the vertices of line and polygon geometries.\n"
61 "Duplicated vertices are errors." );
62}
63
64Qgis::ProcessingAlgorithmFlags QgsGeometryCheckDuplicateNodesAlgorithm::flags() const
65{
67}
68
69QgsGeometryCheckDuplicateNodesAlgorithm *QgsGeometryCheckDuplicateNodesAlgorithm::createInstance() const
70{
71 return new QgsGeometryCheckDuplicateNodesAlgorithm();
72}
73
74void QgsGeometryCheckDuplicateNodesAlgorithm::initAlgorithm( const QVariantMap &configuration )
75{
76 Q_UNUSED( configuration )
77
79 QStringLiteral( "INPUT" ), QObject::tr( "Input layer" ),
80 QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPolygon ) << static_cast<int>( Qgis::ProcessingSourceType::VectorLine )
81 ) );
82 addParameter( new QgsProcessingParameterField(
83 QStringLiteral( "UNIQUE_ID" ), QObject::tr( "Unique feature identifier" ), QString(), QStringLiteral( "INPUT" )
84 ) );
85 addParameter( new QgsProcessingParameterFeatureSink(
86 QStringLiteral( "ERRORS" ), QObject::tr( "Duplicated vertices errors" ), Qgis::ProcessingSourceType::VectorPoint
87 ) );
88 addParameter( new QgsProcessingParameterFeatureSink(
89 QStringLiteral( "OUTPUT" ), QObject::tr( "Duplicated vertices features" ), Qgis::ProcessingSourceType::VectorAnyGeometry, QVariant(), true, false
90 ) );
91
92 std::unique_ptr<QgsProcessingParameterNumber> tolerance = std::make_unique<QgsProcessingParameterNumber>(
93 QStringLiteral( "TOLERANCE" ), QObject::tr( "Tolerance" ), Qgis::ProcessingNumberParameterType::Integer, 8, false, 1, 13
94 );
95 tolerance->setFlags( tolerance->flags() | Qgis::ProcessingParameterFlag::Advanced );
96 tolerance->setHelp( QObject::tr( "The \"Tolerance\" advanced parameter defines the numerical precision of geometric operations, "
97 "given as an integer n, meaning that any difference smaller than 10⁻ⁿ (in map units) is considered zero." ) );
98 addParameter( tolerance.release() );
99}
100
101bool QgsGeometryCheckDuplicateNodesAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
102{
103 mTolerance = parameterAsInt( parameters, QStringLiteral( "TOLERANCE" ), context );
104
105 return true;
106}
107
108QgsFields QgsGeometryCheckDuplicateNodesAlgorithm::outputFields()
109{
110 QgsFields fields;
111 fields.append( QgsField( QStringLiteral( "gc_layerid" ), QMetaType::QString ) );
112 fields.append( QgsField( QStringLiteral( "gc_layername" ), QMetaType::QString ) );
113 fields.append( QgsField( QStringLiteral( "gc_partidx" ), QMetaType::Int ) );
114 fields.append( QgsField( QStringLiteral( "gc_ringidx" ), QMetaType::Int ) );
115 fields.append( QgsField( QStringLiteral( "gc_vertidx" ), QMetaType::Int ) );
116 fields.append( QgsField( QStringLiteral( "gc_errorx" ), QMetaType::Double ) );
117 fields.append( QgsField( QStringLiteral( "gc_errory" ), QMetaType::Double ) );
118 fields.append( QgsField( QStringLiteral( "gc_error" ), QMetaType::QString ) );
119 return fields;
120}
121
122
123QVariantMap QgsGeometryCheckDuplicateNodesAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
124{
125 QString dest_output;
126 QString dest_errors;
127 const std::unique_ptr<QgsProcessingFeatureSource> input( parameterAsSource( parameters, QStringLiteral( "INPUT" ), context ) );
128 if ( !input )
129 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "INPUT" ) ) );
130
131 const QString uniqueIdFieldName( parameterAsString( parameters, QStringLiteral( "UNIQUE_ID" ), context ) );
132 const int uniqueIdFieldIdx = input->fields().indexFromName( uniqueIdFieldName );
133 if ( uniqueIdFieldIdx == -1 )
134 throw QgsProcessingException( QObject::tr( "Missing field %1 in input layer" ).arg( uniqueIdFieldName ) );
135
136 const QgsField uniqueIdField = input->fields().at( uniqueIdFieldIdx );
137
138 QgsFields fields = outputFields();
139 fields.append( uniqueIdField );
140
141 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
142 parameters, QStringLiteral( "OUTPUT" ), context, dest_output, fields, input->wkbType(), input->sourceCrs()
143 ) );
144
145 const std::unique_ptr<QgsFeatureSink> sink_errors( parameterAsSink(
146 parameters, QStringLiteral( "ERRORS" ), context, dest_errors, fields, Qgis::WkbType::Point, input->sourceCrs()
147 ) );
148 if ( !sink_errors )
149 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "ERRORS" ) ) );
150
151 QgsProcessingMultiStepFeedback multiStepFeedback( 3, feedback );
152
153 const QgsProject *project = QgsProject::instance();
154
155 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), project->transformContext(), project );
156
157 // Test detection
158 QList<QgsGeometryCheckError *> checkErrors;
159 QStringList messages;
160
161 QVariantMap configurationCheck;
162 configurationCheck.insert( "minDuplicateNodes", QVariantMap() );
163 const QgsGeometryDuplicateNodesCheck check( &checkContext, configurationCheck );
164
165 multiStepFeedback.setCurrentStep( 1 );
166 feedback->setProgressText( QObject::tr( "Preparing features…" ) );
167 QMap<QString, QgsFeaturePool *> checkerFeaturePools;
168
169 std::unique_ptr<QgsVectorLayer> inputLayer( input->materialize( QgsFeatureRequest() ) );
171 checkerFeaturePools.insert( inputLayer->id(), &featurePool );
172
173 multiStepFeedback.setCurrentStep( 2 );
174 feedback->setProgressText( QObject::tr( "Collecting errors…" ) );
175 check.collectErrors( checkerFeaturePools, checkErrors, messages, feedback );
176
177 multiStepFeedback.setCurrentStep( 3 );
178 feedback->setProgressText( QObject::tr( "Exporting errors…" ) );
179 const double step { checkErrors.size() > 0 ? 100.0 / checkErrors.size() : 1 };
180 long i = 0;
181 feedback->setProgress( 0.0 );
182
183 for ( const QgsGeometryCheckError *error : checkErrors )
184 {
185 if ( feedback->isCanceled() )
186 {
187 break;
188 }
189 QgsFeature f;
190 QgsAttributes attrs = f.attributes();
191
192 attrs << error->layerId()
193 << inputLayer->name()
194 << error->vidx().part
195 << error->vidx().ring
196 << error->vidx().vertex
197 << error->location().x()
198 << error->location().y()
199 << error->value().toString()
200 << inputLayer->getFeature( error->featureId() ).attribute( uniqueIdField.name() );
201 f.setAttributes( attrs );
202
203 f.setGeometry( error->geometry() );
204 if ( sink_output && !sink_output->addFeature( f, QgsFeatureSink::FastInsert ) )
205 throw QgsProcessingException( writeFeatureError( sink_output.get(), parameters, QStringLiteral( "OUTPUT" ) ) );
206
207 f.setGeometry( QgsGeometry::fromPoint( QgsPoint( error->location().x(), error->location().y() ) ) );
208 if ( !sink_errors->addFeature( f, QgsFeatureSink::FastInsert ) )
209 throw QgsProcessingException( writeFeatureError( sink_errors.get(), parameters, QStringLiteral( "ERRORS" ) ) );
210
211 i++;
212 feedback->setProgress( 100.0 * step * static_cast<double>( i ) );
213 }
214
215 // Place the point layer above the other layer
216 if ( context.willLoadLayerOnCompletion( dest_output ) && context.willLoadLayerOnCompletion( dest_errors ) )
217 {
218 context.layerToLoadOnCompletionDetails( dest_errors ).layerSortKey = 0;
219 context.layerToLoadOnCompletionDetails( dest_output ).layerSortKey = 1;
220 }
221
222 // cleanup memory of the pointed data
223 for ( const QgsGeometryCheckError *error : checkErrors )
224 {
225 delete error;
226 }
227
228 QVariantMap outputs;
229 if ( sink_output )
230 outputs.insert( QStringLiteral( "OUTPUT" ), dest_output );
231 outputs.insert( QStringLiteral( "ERRORS" ), dest_errors );
232
233 return outputs;
234}
235
@ VectorAnyGeometry
Any vector layer with geometry.
@ VectorPoint
Vector point layers.
@ VectorPolygon
Vector polygon layers.
@ VectorLine
Vector line layers.
QFlags< ProcessingAlgorithmFlag > ProcessingAlgorithmFlags
Flags indicating how and when an algorithm operates and should be exposed to users.
Definition qgis.h:3476
@ NoThreading
Algorithm is not thread safe and cannot be run in a background thread, e.g. for algorithms which mani...
@ Advanced
Parameter is an advanced parameter which should be hidden from users by default.
A vector of attributes.
Wraps a request for features to a vector layer (or directly its vector data provider).
@ FastInsert
Use faster inserts, at the cost of updating the passed features to reflect changes made at the provid...
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
QgsAttributes attributes
Definition qgsfeature.h:67
void setAttributes(const QgsAttributes &attrs)
Sets the feature's attributes.
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
bool isCanceled() const
Tells whether the operation has been canceled already.
Definition qgsfeedback.h:53
void setProgress(double progress)
Sets the current progress for the feedback object.
Definition qgsfeedback.h:61
Encapsulate a field in an attribute table or data source.
Definition qgsfield.h:53
QString name
Definition qgsfield.h:62
Container of fields for a vector layer.
Definition qgsfields.h:46
bool append(const QgsField &field, Qgis::FieldOrigin origin=Qgis::FieldOrigin::Provider, int originIndex=-1)
Appends a field.
Definition qgsfields.cpp:70
Base configuration for geometry checks.
This represents an error reported by a geometry check.
static QgsGeometry fromPoint(const QgsPoint &point)
Creates a new geometry from a QgsPoint object.
Point geometry type, with support for z-dimension and m-values.
Definition qgspoint.h:49
virtual Qgis::ProcessingAlgorithmFlags flags() const
Returns the flags indicating how and when the algorithm operates and should be exposed to users.
int layerSortKey
Optional sorting key for sorting output layers when loading them into a project.
Contains information about the context in which a processing algorithm is executed.
QgsProcessingContext::LayerDetails & layerToLoadOnCompletionDetails(const QString &layer)
Returns a reference to the details for a given layer which is loaded on completion of the algorithm o...
bool willLoadLayerOnCompletion(const QString &layer) const
Returns true if the given layer (by ID or datasource) will be loaded into the current project upon co...
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
virtual void setProgressText(const QString &text)
Sets a progress report text string.
Processing feedback object for multi-step operations.
A feature sink output for processing algorithms.
An input feature source (such as vector layers) parameter for processing algorithms.
A vector layer or feature source field parameter for processing algorithms.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition qgsproject.h:107
static QgsProject * instance()
Returns the QgsProject singleton instance.
QgsCoordinateTransformContext transformContext
Definition qgsproject.h:113
A feature pool based on a vector data provider.