QGIS API Documentation 3.99.0-Master (357b655ed83)
Loading...
Searching...
No Matches
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
19
23#include "qgspoint.h"
25#include "qgsvectorlayer.h"
26
27#include <QString>
28
29using namespace Qt::StringLiterals;
30
32
33QString QgsGeometryCheckDuplicateNodesAlgorithm::name() const
34{
35 return u"checkgeometryduplicatenodes"_s;
36}
37
38QString QgsGeometryCheckDuplicateNodesAlgorithm::displayName() const
39{
40 return QObject::tr( "Duplicated vertices" );
41}
42
43QString QgsGeometryCheckDuplicateNodesAlgorithm::shortDescription() const
44{
45 return QObject::tr( "Detects duplicated vertices in line and polygon geometries." );
46}
47
48QStringList QgsGeometryCheckDuplicateNodesAlgorithm::tags() const
49{
50 return QObject::tr( "check,geometry,duplicatenodes" ).split( ',' );
51}
52
53QString QgsGeometryCheckDuplicateNodesAlgorithm::group() const
54{
55 return QObject::tr( "Check geometry" );
56}
57
58QString QgsGeometryCheckDuplicateNodesAlgorithm::groupId() const
59{
60 return u"checkgeometry"_s;
61}
62
63QString QgsGeometryCheckDuplicateNodesAlgorithm::shortHelpString() const
64{
65 return QObject::tr( "This algorithm checks the vertices of line and polygon geometries.\n"
66 "Duplicated vertices are errors." );
67}
68
69Qgis::ProcessingAlgorithmFlags QgsGeometryCheckDuplicateNodesAlgorithm::flags() const
70{
72}
73
74QgsGeometryCheckDuplicateNodesAlgorithm *QgsGeometryCheckDuplicateNodesAlgorithm::createInstance() const
75{
76 return new QgsGeometryCheckDuplicateNodesAlgorithm();
77}
78
79void QgsGeometryCheckDuplicateNodesAlgorithm::initAlgorithm( const QVariantMap &configuration )
80{
81 Q_UNUSED( configuration )
82
84 u"INPUT"_s, QObject::tr( "Input layer" ),
85 QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPolygon ) << static_cast<int>( Qgis::ProcessingSourceType::VectorLine )
86 ) );
87 addParameter( new QgsProcessingParameterField(
88 u"UNIQUE_ID"_s, QObject::tr( "Unique feature identifier" ), QString(), u"INPUT"_s
89 ) );
90 addParameter( new QgsProcessingParameterFeatureSink(
91 u"ERRORS"_s, QObject::tr( "Duplicated vertices errors" ), Qgis::ProcessingSourceType::VectorPoint
92 ) );
93 addParameter( new QgsProcessingParameterFeatureSink(
94 u"OUTPUT"_s, QObject::tr( "Duplicated vertices features" ), Qgis::ProcessingSourceType::VectorAnyGeometry, QVariant(), true, false
95 ) );
96
97 auto tolerance = std::make_unique<QgsProcessingParameterNumber>(
98 u"TOLERANCE"_s, QObject::tr( "Tolerance" ), Qgis::ProcessingNumberParameterType::Integer, 8, false, 1, 13
99 );
100 tolerance->setFlags( tolerance->flags() | Qgis::ProcessingParameterFlag::Advanced );
101 tolerance->setHelp( QObject::tr( "The \"Tolerance\" advanced parameter defines the numerical precision of geometric operations, "
102 "given as an integer n, meaning that any difference smaller than 10⁻ⁿ (in map units) is considered zero." ) );
103 addParameter( tolerance.release() );
104}
105
106bool QgsGeometryCheckDuplicateNodesAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
107{
108 mTolerance = parameterAsInt( parameters, u"TOLERANCE"_s, context );
109
110 return true;
111}
112
113QgsFields QgsGeometryCheckDuplicateNodesAlgorithm::outputFields()
114{
115 QgsFields fields;
116 fields.append( QgsField( u"gc_layerid"_s, QMetaType::QString ) );
117 fields.append( QgsField( u"gc_layername"_s, QMetaType::QString ) );
118 fields.append( QgsField( u"gc_partidx"_s, QMetaType::Int ) );
119 fields.append( QgsField( u"gc_ringidx"_s, QMetaType::Int ) );
120 fields.append( QgsField( u"gc_vertidx"_s, QMetaType::Int ) );
121 fields.append( QgsField( u"gc_errorx"_s, QMetaType::Double ) );
122 fields.append( QgsField( u"gc_errory"_s, QMetaType::Double ) );
123 fields.append( QgsField( u"gc_error"_s, QMetaType::QString ) );
124 return fields;
125}
126
127QVariantMap QgsGeometryCheckDuplicateNodesAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
128{
129 QString dest_output;
130 QString dest_errors;
131 const std::unique_ptr<QgsProcessingFeatureSource> input( parameterAsSource( parameters, u"INPUT"_s, context ) );
132 if ( !input )
133 throw QgsProcessingException( invalidSourceError( parameters, u"INPUT"_s ) );
134
135 const QString uniqueIdFieldName( parameterAsString( parameters, u"UNIQUE_ID"_s, context ) );
136 const int uniqueIdFieldIdx = input->fields().indexFromName( uniqueIdFieldName );
137 if ( uniqueIdFieldIdx == -1 )
138 throw QgsProcessingException( QObject::tr( "Missing field %1 in input layer" ).arg( uniqueIdFieldName ) );
139
140 const QgsField uniqueIdField = input->fields().at( uniqueIdFieldIdx );
141
142 QgsFields fields = outputFields();
143 fields.append( uniqueIdField );
144
145 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
146 parameters, u"OUTPUT"_s, context, dest_output, fields, input->wkbType(), input->sourceCrs()
147 ) );
148
149 const std::unique_ptr<QgsFeatureSink> sink_errors( parameterAsSink(
150 parameters, u"ERRORS"_s, context, dest_errors, fields, Qgis::WkbType::Point, input->sourceCrs()
151 ) );
152 if ( !sink_errors )
153 throw QgsProcessingException( invalidSinkError( parameters, u"ERRORS"_s ) );
154
155 QgsProcessingMultiStepFeedback multiStepFeedback( 3, feedback );
156
157 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), context.transformContext(), context.project(), uniqueIdFieldIdx );
158
159 // Test detection
160 QList<QgsGeometryCheckError *> checkErrors;
161 QStringList messages;
162
163 QVariantMap configurationCheck;
164 configurationCheck.insert( "minDuplicateNodes", QVariantMap() );
165 const QgsGeometryDuplicateNodesCheck check( &checkContext, configurationCheck );
166
167 multiStepFeedback.setCurrentStep( 1 );
168 feedback->setProgressText( QObject::tr( "Preparing features…" ) );
169 QMap<QString, QgsFeaturePool *> checkerFeaturePools;
170
171 std::unique_ptr<QgsVectorLayer> inputLayer( input->materialize( QgsFeatureRequest() ) );
173 checkerFeaturePools.insert( inputLayer->id(), &featurePool );
174
175 multiStepFeedback.setCurrentStep( 2 );
176 feedback->setProgressText( QObject::tr( "Collecting errors…" ) );
177 QgsGeometryCheck::Result res = check.collectErrors( checkerFeaturePools, checkErrors, messages, feedback );
179 {
180 feedback->pushInfo( QObject::tr( "Errors collected successfully." ) );
181 }
182 else if ( res == QgsGeometryCheck::Result::Canceled )
183 {
184 throw QgsProcessingException( QObject::tr( "Operation was canceled." ) );
185 }
187 {
188 throw QgsProcessingException( QObject::tr( "Field '%1' contains non-unique values and can not be used as unique ID." ).arg( uniqueIdFieldName ) );
189 }
190
191 multiStepFeedback.setCurrentStep( 3 );
192 feedback->setProgressText( QObject::tr( "Exporting errors…" ) );
193 const double step { checkErrors.size() > 0 ? 100.0 / checkErrors.size() : 1 };
194 long i = 0;
195 feedback->setProgress( 0.0 );
196
197 for ( const QgsGeometryCheckError *error : checkErrors )
198 {
199 if ( feedback->isCanceled() )
200 {
201 break;
202 }
203 QgsFeature f;
204 QgsAttributes attrs = f.attributes();
205
206 attrs << error->layerId()
207 << inputLayer->name()
208 << error->vidx().part
209 << error->vidx().ring
210 << error->vidx().vertex
211 << error->location().x()
212 << error->location().y()
213 << error->value().toString()
214 << inputLayer->getFeature( error->featureId() ).attribute( uniqueIdField.name() );
215 f.setAttributes( attrs );
216
217 f.setGeometry( error->geometry() );
218 if ( sink_output && !sink_output->addFeature( f, QgsFeatureSink::FastInsert ) )
219 throw QgsProcessingException( writeFeatureError( sink_output.get(), parameters, u"OUTPUT"_s ) );
220
221 f.setGeometry( QgsGeometry::fromPoint( QgsPoint( error->location().x(), error->location().y() ) ) );
222 if ( !sink_errors->addFeature( f, QgsFeatureSink::FastInsert ) )
223 throw QgsProcessingException( writeFeatureError( sink_errors.get(), parameters, u"ERRORS"_s ) );
224
225 i++;
226 feedback->setProgress( 100.0 * step * static_cast<double>( i ) );
227 }
228
229 // Place the point layer above the other layer
230 if ( context.willLoadLayerOnCompletion( dest_output ) && context.willLoadLayerOnCompletion( dest_errors ) )
231 {
232 context.layerToLoadOnCompletionDetails( dest_errors ).layerSortKey = 0;
233 context.layerToLoadOnCompletionDetails( dest_output ).layerSortKey = 1;
234 }
235
236 // cleanup memory of the pointed data
237 for ( const QgsGeometryCheckError *error : checkErrors )
238 {
239 delete error;
240 }
241
242 QVariantMap outputs;
243 if ( sink_output )
244 outputs.insert( u"OUTPUT"_s, dest_output );
245 outputs.insert( u"ERRORS"_s, dest_errors );
246
247 return outputs;
248}
249
@ VectorAnyGeometry
Any vector layer with geometry.
Definition qgis.h:3604
@ VectorPoint
Vector point layers.
Definition qgis.h:3605
@ VectorPolygon
Vector polygon layers.
Definition qgis.h:3607
@ VectorLine
Vector line layers.
Definition qgis.h:3606
QFlags< ProcessingAlgorithmFlag > ProcessingAlgorithmFlags
Flags indicating how and when an algorithm operates and should be exposed to users.
Definition qgis.h:3680
@ Point
Point.
Definition qgis.h:282
@ NoThreading
Algorithm is not thread safe and cannot be run in a background thread, e.g. for algorithms which mani...
Definition qgis.h:3659
@ RequiresProject
The algorithm requires that a valid QgsProject is available from the processing context in order to e...
Definition qgis.h:3667
@ Advanced
Parameter is an advanced parameter which should be hidden from users by default.
Definition qgis.h:3834
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:60
QgsAttributes attributes
Definition qgsfeature.h:69
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:55
void setProgress(double progress)
Sets the current progress for the feedback object.
Definition qgsfeedback.h:63
Encapsulate a field in an attribute table or data source.
Definition qgsfield.h:56
QString name
Definition qgsfield.h:65
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:76
Base configuration for geometry checks.
This represents an error reported by a geometry check.
Result
Result of the geometry checker operation.
@ Canceled
User canceled calculation.
@ DuplicatedUniqueId
Found duplicated unique ID value.
@ Success
Operation completed successfully.
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:53
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...
QgsCoordinateTransformContext transformContext() const
Returns the coordinate transform context.
QgsProject * project() const
Returns the project in which the algorithm is being executed.
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 pushInfo(const QString &info)
Pushes a general informational message from the 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.
A feature pool based on a vector data provider.