QGIS API Documentation 3.43.0-Master (e01d6d7c4c0)
qgsalgorithmfixgeometryoverlap.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmfixgeometryoverlap.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
23#include "qgsvectorlayer.h"
24#include "qgsvectorfilewriter.h"
25
27
28QString QgsFixGeometryOverlapAlgorithm::name() const
29{
30 return QStringLiteral( "fixgeometryoverlap" );
31}
32
33QString QgsFixGeometryOverlapAlgorithm::displayName() const
34{
35 return QObject::tr( "Delete overlaps" );
36}
37
38QString QgsFixGeometryOverlapAlgorithm::shortDescription() const
39{
40 return QObject::tr( "Deletes overlaps detected with the \"Overlaps\" algorithm from the \"Check geometry\" section." );
41}
42
43QStringList QgsFixGeometryOverlapAlgorithm::tags() const
44{
45 return QObject::tr( "delete,area,fix,overlap" ).split( ',' );
46}
47
48QString QgsFixGeometryOverlapAlgorithm::group() const
49{
50 return QObject::tr( "Fix geometry" );
51}
52
53QString QgsFixGeometryOverlapAlgorithm::groupId() const
54{
55 return QStringLiteral( "fixgeometry" );
56}
57
58QString QgsFixGeometryOverlapAlgorithm::shortHelpString() const
59{
60 return QObject::tr( "This algorithm deletes overlap sections based on an error layer from the \"Overlap\" algorithm in the \"Check geometry\" section.\n" );
61}
62
63QgsFixGeometryOverlapAlgorithm *QgsFixGeometryOverlapAlgorithm::createInstance() const
64{
65 return new QgsFixGeometryOverlapAlgorithm();
66}
67
68void QgsFixGeometryOverlapAlgorithm::initAlgorithm( const QVariantMap &configuration )
69{
70 Q_UNUSED( configuration )
71
72 // Inputs
74 QStringLiteral( "INPUT" ), QObject::tr( "Input layer" ), QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPolygon )
75 ) );
77 QStringLiteral( "ERRORS" ), QObject::tr( "Error layer" ), QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPoint )
78 ) );
79 addParameter( new QgsProcessingParameterField(
80 QStringLiteral( "UNIQUE_ID" ), QObject::tr( "Field of original feature unique identifier" ),
81 QString(), QStringLiteral( "ERRORS" )
82 ) );
83 addParameter( new QgsProcessingParameterField(
84 QStringLiteral( "OVERLAP_FEATURE_UNIQUE_IDX" ), QObject::tr( "Field of overlap feature unique identifier" ),
85 QString(), QStringLiteral( "ERRORS" ),
87 ) );
88 addParameter( new QgsProcessingParameterField(
89 QStringLiteral( "ERROR_VALUE_ID" ), QObject::tr( "Field of error value" ),
90 QStringLiteral( "gc_error" ), QStringLiteral( "ERRORS" ),
92 ) );
93
94 // Outputs
95 addParameter( new QgsProcessingParameterFeatureSink(
96 QStringLiteral( "OUTPUT" ), QObject::tr( "No-overlap layer" ), Qgis::ProcessingSourceType::VectorPolygon
97 ) );
98 addParameter( new QgsProcessingParameterFeatureSink(
99 QStringLiteral( "REPORT" ), QObject::tr( "Report layer from fixing overlaps" ), Qgis::ProcessingSourceType::VectorPoint
100 ) );
101
102 std::unique_ptr<QgsProcessingParameterNumber> tolerance = std::make_unique<QgsProcessingParameterNumber>(
103 QStringLiteral( "TOLERANCE" ), QObject::tr( "Tolerance" ), Qgis::ProcessingNumberParameterType::Integer, 8, false, 1, 13
104 );
105 tolerance->setFlags( tolerance->flags() | Qgis::ProcessingParameterFlag::Advanced );
106 tolerance->setHelp( QObject::tr( "The \"Tolerance\" advanced parameter defines the numerical precision of geometric operations, "
107 "given as an integer n, meaning that any difference smaller than 10⁻ⁿ (in map units) is considered zero." ) );
108 addParameter( tolerance.release() );
109}
110
111QVariantMap QgsFixGeometryOverlapAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
112{
113 const std::unique_ptr<QgsProcessingFeatureSource> input( parameterAsSource( parameters, QStringLiteral( "INPUT" ), context ) );
114 if ( !input )
115 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "INPUT" ) ) );
116
117 const std::unique_ptr<QgsProcessingFeatureSource> errors( parameterAsSource( parameters, QStringLiteral( "ERRORS" ), context ) );
118 if ( !errors )
119 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "ERRORS" ) ) );
120
121 QgsProcessingMultiStepFeedback multiStepFeedback( 2, feedback );
122
123 const QString featIdFieldName = parameterAsString( parameters, QStringLiteral( "UNIQUE_ID" ), context );
124 const QString overlapFeatIdFieldName = parameterAsString( parameters, QStringLiteral( "OVERLAP_FEATURE_UNIQUE_IDX" ), context );
125 const QString errorValueIdFieldName = parameterAsString( parameters, QStringLiteral( "ERROR_VALUE_ID" ), context );
126
127 // Verify that input fields exists
128 if ( errors->fields().indexFromName( featIdFieldName ) == -1 )
129 throw QgsProcessingException( QObject::tr( "Field \"%1\" does not exist in the error layer." ).arg( featIdFieldName ) );
130 if ( errors->fields().indexFromName( errorValueIdFieldName ) == -1 )
131 throw QgsProcessingException( QObject::tr( "Field \"%1\" does not exist in the error layer." ).arg( errorValueIdFieldName ) );
132 int overlapIdFieldIndex = errors->fields().indexFromName( overlapFeatIdFieldName );
133 if ( overlapIdFieldIndex == -1 )
134 throw QgsProcessingException( QObject::tr( "Field \"%1\" does not exist in the error layer." ).arg( overlapFeatIdFieldName ) );
135 int inputIdFieldIndex = input->fields().indexFromName( featIdFieldName );
136 if ( inputIdFieldIndex == -1 )
137 throw QgsProcessingException( QObject::tr( "Field \"%1\" does not exist in input layer." ).arg( featIdFieldName ) );
138
139 const QgsField inputFeatIdField = input->fields().at( inputIdFieldIndex );
140 const QMetaType::Type inputFeatIdFieldType = inputFeatIdField.type();
141 if ( inputFeatIdFieldType != errors->fields().at( errors->fields().indexFromName( featIdFieldName ) ).type() )
142 throw QgsProcessingException( QObject::tr( "Field \"%1\" does not have the same type as in the error layer." ).arg( featIdFieldName ) );
143
144 const QgsField overlapFeatIdField = errors->fields().at( overlapIdFieldIndex );
145 const QMetaType::Type overlapFeatIdFieldType = overlapFeatIdField.type();
146 if ( inputFeatIdFieldType != errors->fields().at( errors->fields().indexFromName( overlapFeatIdFieldName ) ).type() )
147 throw QgsProcessingException( QObject::tr( "Field \"%1\" does not have the same type as \"%2\" in the input layer." ).arg( overlapFeatIdFieldName ).arg( featIdFieldName ) );
148
149 QString dest_output;
150 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
151 parameters, QStringLiteral( "OUTPUT" ), context, dest_output, input->fields(), input->wkbType(), input->sourceCrs()
152 ) );
153 if ( !sink_output )
154 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "OUTPUT" ) ) );
155
156 QString dest_report;
157 QgsFields reportFields = errors->fields();
158 reportFields.append( QgsField( QStringLiteral( "report" ), QMetaType::QString ) );
159 reportFields.append( QgsField( QStringLiteral( "error_fixed" ), QMetaType::Bool ) );
160 const std::unique_ptr<QgsFeatureSink> sink_report( parameterAsSink(
161 parameters, QStringLiteral( "REPORT" ), context, dest_report, reportFields, errors->wkbType(), errors->sourceCrs()
162 ) );
163 if ( !sink_report )
164 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "REPORT" ) ) );
165
166 const QgsProject *project = QgsProject::instance();
167 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), project->transformContext(), project );
168 QStringList messages;
169
170 const QgsGeometryOverlapCheck check( &checkContext, QVariantMap() );
171
172 std::unique_ptr<QgsVectorLayer> fixedLayer( input->materialize( QgsFeatureRequest() ) );
174 QMap<QString, QgsFeaturePool *> featurePools;
175 featurePools.insert( fixedLayer->id(), &featurePool );
176
177 QgsFeature errorFeature, inputFeature, overlapFeature, testDuplicateIdFeature;
178 QgsFeatureIterator errorFeaturesIt = errors->getFeatures();
179 QList<QgsGeometryCheck::Changes> changesList;
180 QgsFeature reportFeature;
181 reportFeature.setFields( reportFields );
182 long long progression = 0;
183 long long totalProgression = errors->featureCount();
184 multiStepFeedback.setCurrentStep( 1 );
185 multiStepFeedback.setProgressText( QObject::tr( "Fixing errors..." ) );
186 while ( errorFeaturesIt.nextFeature( errorFeature ) )
187 {
188 if ( feedback->isCanceled() )
189 break;
190
191 progression++;
192 multiStepFeedback.setProgress( static_cast<double>( static_cast<long double>( progression ) / totalProgression ) * 100 );
193 reportFeature.setGeometry( errorFeature.geometry() );
194
195 QString idValue = errorFeature.attribute( featIdFieldName ).toString();
196 if ( inputFeatIdFieldType == QMetaType::QString )
197 idValue = "'" + idValue + "'";
198 QgsFeatureIterator it = fixedLayer->getFeatures( QgsFeatureRequest().setFilterExpression( "\"" + featIdFieldName + "\" = " + idValue ) );
199
200 QString overlapIdValue = errorFeature.attribute( overlapFeatIdFieldName ).toString();
201 if ( overlapFeatIdFieldType == QMetaType::QString )
202 overlapIdValue = "'" + overlapIdValue + "'";
203 QgsFeatureIterator overlapIt = fixedLayer->getFeatures( QgsFeatureRequest().setFilterExpression( "\"" + featIdFieldName + "\" = " + overlapIdValue ) );
204
205 if ( !it.nextFeature( inputFeature ) || !inputFeature.isValid() )
206 reportFeature.setAttributes( errorFeature.attributes() << QObject::tr( "Source feature not found or invalid" ) << false );
207
208 else if ( !overlapIt.nextFeature( overlapFeature ) || !overlapFeature.isValid() )
209 reportFeature.setAttributes( errorFeature.attributes() << QObject::tr( "Overlap feature not found or invalid" ) << false );
210
211 else if ( it.nextFeature( testDuplicateIdFeature ) )
212 throw QgsProcessingException( QObject::tr( "More than one feature found in input layer with value \"%1\" in unique field \"%2\"" ).arg( idValue ).arg( featIdFieldName ) );
213
214 else if ( overlapIt.nextFeature( testDuplicateIdFeature ) )
215 throw QgsProcessingException( QObject::tr( "More than one overlap feature found in input layer with value \"%1\" in unique field \"%2\"" ).arg( overlapIdValue ).arg( overlapFeatIdFieldName ) );
216
217 else if ( inputFeature.geometry().isNull() )
218 reportFeature.setAttributes( errorFeature.attributes() << QObject::tr( "Feature geometry is null" ) << false );
219
220 else if ( overlapFeature.geometry().isNull() )
221 reportFeature.setAttributes( errorFeature.attributes() << QObject::tr( "Overlap feature geometry is null" ) << false );
222
223 else
224 {
226 &check,
227 QgsGeometryCheckerUtils::LayerFeature( &featurePool, inputFeature, &checkContext, false ),
228 inputFeature.geometry(),
229 errorFeature.geometry().asPoint(),
230 errorFeature.attribute( errorValueIdFieldName ),
231 QgsGeometryCheckerUtils::LayerFeature( &featurePool, overlapFeature, &checkContext, false )
232 );
233 for ( QgsGeometryCheck::Changes changes : changesList )
234 checkError.handleChanges( changes );
235
237 check.fixError( featurePools, &checkError, QgsGeometryOverlapCheck::ResolutionMethod::Subtract, QMap<QString, int>(), changes );
238 changesList << changes;
239 QString resolutionMessage = checkError.resolutionMessage();
240 if ( checkError.status() == QgsGeometryCheckError::StatusObsolete )
241 resolutionMessage = QObject::tr( "Error is obsolete" );
242 reportFeature.setAttributes( errorFeature.attributes() << resolutionMessage << ( checkError.status() == QgsGeometryCheckError::StatusFixed ) );
243 }
244
245 if ( !sink_report->addFeature( reportFeature, QgsFeatureSink::FastInsert ) )
246 throw QgsProcessingException( writeFeatureError( sink_report.get(), parameters, QStringLiteral( "REPORT" ) ) );
247 }
248 multiStepFeedback.setProgress( 100 );
249
250 progression = 0;
251 totalProgression = fixedLayer->featureCount();
252 multiStepFeedback.setCurrentStep( 2 );
253 multiStepFeedback.setProgressText( QObject::tr( "Exporting fixed layer..." ) );
254 QgsFeature fixedFeature;
255 QgsFeatureIterator fixedFeaturesIt = fixedLayer->getFeatures();
256 while ( fixedFeaturesIt.nextFeature( fixedFeature ) )
257 {
258 if ( feedback->isCanceled() )
259 break;
260
261 progression++;
262 multiStepFeedback.setProgress( static_cast<double>( static_cast<long double>( progression ) / totalProgression ) * 100 );
263 if ( !sink_output->addFeature( fixedFeature, QgsFeatureSink::FastInsert ) )
264 throw QgsProcessingException( writeFeatureError( sink_output.get(), parameters, QStringLiteral( "OUTPUT" ) ) );
265 }
266 multiStepFeedback.setProgress( 100 );
267
268 QVariantMap outputs;
269 outputs.insert( QStringLiteral( "OUTPUT" ), dest_output );
270 outputs.insert( QStringLiteral( "REPORT" ), dest_report );
271
272 return outputs;
273}
274
275bool QgsFixGeometryOverlapAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
276{
277 mTolerance = parameterAsInt( parameters, QStringLiteral( "TOLERANCE" ), context );
278
279 return true;
280}
281
282Qgis::ProcessingAlgorithmFlags QgsFixGeometryOverlapAlgorithm::flags() const
283{
285}
286
@ VectorPoint
Vector point layers.
@ VectorPolygon
Vector polygon layers.
@ Numeric
Accepts numeric fields.
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.
Wrapper for iterator of features from vector data provider or vector layer.
bool nextFeature(QgsFeature &f)
Fetch next feature and stores in f, returns true on success.
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 setFields(const QgsFields &fields, bool initAttributes=false)
Assigns a field map with the feature to allow attribute access by attribute name.
QgsGeometry geometry
Definition qgsfeature.h:69
bool isValid() const
Returns the validity of this feature.
Q_INVOKABLE QVariant attribute(const QString &name) const
Lookup attribute value by attribute name.
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
Encapsulate a field in an attribute table or data source.
Definition qgsfield.h:53
QMetaType::Type type
Definition qgsfield.h:60
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.
@ StatusFixed
The error is fixed.
@ StatusObsolete
The error is obsolete because of other modifications.
Status status() const
The status of the error.
QString resolutionMessage() const
A message with details, how the error has been resolved.
QMap< QString, QMap< QgsFeatureId, QList< QgsGeometryCheck::Change > > > Changes
A collection of changes.
A layer feature combination to uniquely identify and access a feature in a set of layers.
An error of a QgsGeometryOverlapCheck.
Checks if geometries overlap.
@ Subtract
Subtract the overlap region from the polygon.
QgsPointXY asPoint() const
Returns the contents of the geometry as a 2-dimensional point.
virtual Qgis::ProcessingAlgorithmFlags flags() const
Returns the flags indicating how and when the algorithm operates and should be exposed to users.
Contains information about the context in which a processing algorithm is executed.
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
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.