QGIS API Documentation 3.43.0-Master (c4a2e9c6d2f)
qgsalgorithmcheckgeometryoverlap.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmcheckgeometryoverlap.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 QgsGeometryCheckOverlapAlgorithm::name() const
29{
30 return QStringLiteral( "checkgeometryoverlap" );
31}
32
33QString QgsGeometryCheckOverlapAlgorithm::displayName() const
34{
35 return QObject::tr( "Check Geometry (Overlap)" );
36}
37
38QStringList QgsGeometryCheckOverlapAlgorithm::tags() const
39{
40 return QObject::tr( "check,geometry,overlap" ).split( ',' );
41}
42
43QString QgsGeometryCheckOverlapAlgorithm::group() const
44{
45 return QObject::tr( "Check geometry" );
46}
47
48QString QgsGeometryCheckOverlapAlgorithm::groupId() const
49{
50 return QStringLiteral( "checkgeometry" );
51}
52
53QString QgsGeometryCheckOverlapAlgorithm::shortHelpString() const
54{
55 return QObject::tr( "This algorithm checks the overlapping areas.\n"
56 "Overlapping areas smaller than the minimum overlapping area are errors." );
57}
58
59Qgis::ProcessingAlgorithmFlags QgsGeometryCheckOverlapAlgorithm::flags() const
60{
62}
63
64QgsGeometryCheckOverlapAlgorithm *QgsGeometryCheckOverlapAlgorithm::createInstance() const
65{
66 return new QgsGeometryCheckOverlapAlgorithm();
67}
68
69void QgsGeometryCheckOverlapAlgorithm::initAlgorithm( const QVariantMap &configuration )
70{
71 Q_UNUSED( configuration )
72
74 QStringLiteral( "INPUT" ), QObject::tr( "Input layer" ), QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPolygon )
75 ) );
76 addParameter( new QgsProcessingParameterField(
77 QStringLiteral( "UNIQUE_ID" ), QObject::tr( "Unique feature identifier" ), QString(), QStringLiteral( "INPUT" )
78 ) );
79 addParameter( new QgsProcessingParameterFeatureSink(
80 QStringLiteral( "ERRORS" ), QObject::tr( "Errors layer" ), Qgis::ProcessingSourceType::VectorPoint
81 ) );
82 addParameter( new QgsProcessingParameterFeatureSink(
83 QStringLiteral( "OUTPUT" ), QObject::tr( "Output layer" ), Qgis::ProcessingSourceType::VectorPolygon
84 ) );
85
86 addParameter( new QgsProcessingParameterNumber(
87 QStringLiteral( "MIN_OVERLAP_AREA" ), QObject::tr( "min overlap area" ), Qgis::ProcessingNumberParameterType::Double, 0, false, 0.0, 180.0
88 ) );
89
90 std::unique_ptr<QgsProcessingParameterNumber> tolerance = std::make_unique<QgsProcessingParameterNumber>(
91 QStringLiteral( "TOLERANCE" ), QObject::tr( "Tolerance" ), Qgis::ProcessingNumberParameterType::Integer, 8, false, 1, 13
92 );
93 tolerance->setFlags( tolerance->flags() | Qgis::ProcessingParameterFlag::Advanced );
94 addParameter( tolerance.release() );
95}
96
97bool QgsGeometryCheckOverlapAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
98{
99 mTolerance = parameterAsInt( parameters, QStringLiteral( "TOLERANCE" ), context );
100
101 return true;
102}
103
104QgsFields QgsGeometryCheckOverlapAlgorithm::outputFields()
105{
106 QgsFields fields;
107 fields.append( QgsField( QStringLiteral( "gc_layerid" ), QMetaType::QString ) );
108 fields.append( QgsField( QStringLiteral( "gc_layername" ), QMetaType::QString ) );
109 fields.append( QgsField( QStringLiteral( "gc_errorx" ), QMetaType::Double ) );
110 fields.append( QgsField( QStringLiteral( "gc_errory" ), QMetaType::Double ) );
111 fields.append( QgsField( QStringLiteral( "gc_error" ), QMetaType::Double ) );
112 return fields;
113}
114
115
116QVariantMap QgsGeometryCheckOverlapAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
117{
118 QString dest_output;
119 QString dest_errors;
120 const std::unique_ptr<QgsProcessingFeatureSource> input( parameterAsSource( parameters, QStringLiteral( "INPUT" ), context ) );
121 if ( !input )
122 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "INPUT" ) ) );
123
124 QString uniqueIdFieldName( parameterAsString( parameters, QStringLiteral( "UNIQUE_ID" ), context ) );
125 int uniqueIdFieldIdx = input->fields().indexFromName( uniqueIdFieldName );
126 if ( uniqueIdFieldIdx == -1 )
127 throw QgsProcessingException( QObject::tr( "Missing field %1 in input layer" ).arg( uniqueIdFieldName ) );
128
129 const QgsField uniqueIdField = input->fields().at( uniqueIdFieldIdx );
130 QgsField overlapFeatureUniqueIdField = input->fields().at( uniqueIdFieldIdx );
131 overlapFeatureUniqueIdField.setName( "gc_overlap_feature_" + uniqueIdField.name() );
132
133 QgsFields fields = outputFields();
134 fields.append( uniqueIdField );
135 fields.append( overlapFeatureUniqueIdField );
136
137 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
138 parameters, QStringLiteral( "OUTPUT" ), context, dest_output, fields, input->wkbType(), input->sourceCrs()
139 ) );
140 if ( !sink_output )
141 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "OUTPUT" ) ) );
142
143 const std::unique_ptr<QgsFeatureSink> sink_errors( parameterAsSink(
144 parameters, QStringLiteral( "ERRORS" ), context, dest_errors, fields, Qgis::WkbType::Point, input->sourceCrs()
145 ) );
146 if ( !sink_errors )
147 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "ERRORS" ) ) );
148
149 QgsProcessingMultiStepFeedback multiStepFeedback( 3, feedback );
150
151 const QgsProject *project = QgsProject::instance();
152
153 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), project->transformContext(), project );
154
155 // Test detection
156 QList<QgsGeometryCheckError *> checkErrors;
157 QStringList messages;
158
159 const double minOverlapArea = parameterAsDouble( parameters, QStringLiteral( "MIN_OVERLAP_AREA" ), context );
160
161 QVariantMap configurationCheck;
162 configurationCheck.insert( "maxOverlapArea", minOverlapArea );
163 const QgsGeometryOverlapCheck 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 const QgsGeometryOverlapCheckError *overlapError = dynamic_cast<const QgsGeometryOverlapCheckError *>( error );
186 if ( !overlapError )
187 break;
188 if ( feedback->isCanceled() )
189 break;
190
191 QgsFeature f;
192 QgsAttributes attrs = f.attributes();
193
194 attrs << error->layerId()
195 << inputLayer->name()
196 << error->location().x()
197 << error->location().y()
198 << error->value().toDouble()
199 << inputLayer->getFeature( error->featureId() ).attribute( uniqueIdField.name() )
200 << inputLayer->getFeature( overlapError->overlappedFeature().featureId() ).attribute( uniqueIdField.name() );
201 f.setAttributes( attrs );
202
203 f.setGeometry( error->geometry() );
204 if ( !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 polygon 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 QVariantMap outputs;
223 outputs.insert( QStringLiteral( "OUTPUT" ), dest_output );
224 outputs.insert( QStringLiteral( "ERRORS" ), dest_errors );
225
226 return outputs;
227}
228
@ VectorPoint
Vector point layers.
@ VectorPolygon
Vector polygon 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
void setName(const QString &name)
Set the field name.
Definition qgsfield.cpp:228
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.
An error of a QgsGeometryOverlapCheck.
const OverlappedFeature & overlappedFeature() const
Returns the overlapped feature.
Checks if geometries overlap.
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.
A numeric 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.