QGIS API Documentation 3.43.0-Master (c4a2e9c6d2f)
qgsalgorithmcheckgeometrymultipart.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmcheckgeometrymultipart.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 QgsGeometryCheckMultipartAlgorithm::name() const
29{
30 return QStringLiteral( "checkgeometrymultipart" );
31}
32
33QString QgsGeometryCheckMultipartAlgorithm::displayName() const
34{
35 return QObject::tr( "Check Geometry (Strict Multipart)" );
36}
37
38QStringList QgsGeometryCheckMultipartAlgorithm::tags() const
39{
40 return QObject::tr( "check,geometry,multipart" ).split( ',' );
41}
42
43QString QgsGeometryCheckMultipartAlgorithm::group() const
44{
45 return QObject::tr( "Check geometry" );
46}
47
48QString QgsGeometryCheckMultipartAlgorithm::groupId() const
49{
50 return QStringLiteral( "checkgeometry" );
51}
52
53QString QgsGeometryCheckMultipartAlgorithm::shortHelpString() const
54{
55 return QObject::tr( "This algorithm checks if multipart geometries have more than one part.\n"
56 "Multipart geometries with only one part are errors." );
57}
58
59Qgis::ProcessingAlgorithmFlags QgsGeometryCheckMultipartAlgorithm::flags() const
60{
62}
63
64QgsGeometryCheckMultipartAlgorithm *QgsGeometryCheckMultipartAlgorithm::createInstance() const
65{
66 return new QgsGeometryCheckMultipartAlgorithm();
67}
68
69void QgsGeometryCheckMultipartAlgorithm::initAlgorithm( const QVariantMap &configuration )
70{
71 Q_UNUSED( configuration )
72
74 QStringLiteral( "INPUT" ),
75 QObject::tr( "Input layer" ),
76 QList<int>()
78 << static_cast<int>( Qgis::ProcessingSourceType::VectorLine )
79 ) );
80 addParameter( new QgsProcessingParameterField(
81 QStringLiteral( "UNIQUE_ID" ), QObject::tr( "Unique feature identifier" ), QString(), QStringLiteral( "INPUT" )
82 ) );
83 addParameter( new QgsProcessingParameterFeatureSink(
84 QStringLiteral( "ERRORS" ), QObject::tr( "Errors layer" ), Qgis::ProcessingSourceType::VectorPoint
85 ) );
86 addParameter( new QgsProcessingParameterFeatureSink(
87 QStringLiteral( "OUTPUT" ), QObject::tr( "Output layer" ), Qgis::ProcessingSourceType::VectorAnyGeometry
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 QgsGeometryCheckMultipartAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
98{
99 mTolerance = parameterAsInt( parameters, QStringLiteral( "TOLERANCE" ), context );
100 return true;
101}
102
103QgsFields QgsGeometryCheckMultipartAlgorithm::outputFields()
104{
105 QgsFields fields;
106 fields.append( QgsField( QStringLiteral( "gc_layerid" ), QMetaType::QString ) );
107 fields.append( QgsField( QStringLiteral( "gc_layername" ), QMetaType::QString ) );
108 fields.append( QgsField( QStringLiteral( "gc_partidx" ), QMetaType::Int ) );
109 fields.append( QgsField( QStringLiteral( "gc_ringidx" ), QMetaType::Int ) );
110 fields.append( QgsField( QStringLiteral( "gc_vertidx" ), QMetaType::Int ) );
111 fields.append( QgsField( QStringLiteral( "gc_errorx" ), QMetaType::Double ) );
112 fields.append( QgsField( QStringLiteral( "gc_errory" ), QMetaType::Double ) );
113 fields.append( QgsField( QStringLiteral( "gc_error" ), QMetaType::QString ) );
114 return fields;
115}
116
117
118QVariantMap QgsGeometryCheckMultipartAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
119{
120 QString dest_output;
121 QString dest_errors;
122 const std::unique_ptr<QgsProcessingFeatureSource> input( parameterAsSource( parameters, QStringLiteral( "INPUT" ), context ) );
123 if ( !input )
124 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "INPUT" ) ) );
125
126 const QString uniqueIdFieldName( parameterAsString( parameters, QStringLiteral( "UNIQUE_ID" ), context ) );
127 const int uniqueIdFieldIdx = input->fields().indexFromName( uniqueIdFieldName );
128 if ( uniqueIdFieldIdx == -1 )
129 throw QgsProcessingException( QObject::tr( "Missing field %1 in input layer" ).arg( uniqueIdFieldName ) );
130
131 const QgsField uniqueIdField = input->fields().at( uniqueIdFieldIdx );
132
133 QgsFields fields = outputFields();
134 fields.append( uniqueIdField );
135
136 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
137 parameters, QStringLiteral( "OUTPUT" ), context, dest_output, fields, input->wkbType(), input->sourceCrs()
138 ) );
139 if ( !sink_output )
140 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "OUTPUT" ) ) );
141
142 const std::unique_ptr<QgsFeatureSink> sink_errors( parameterAsSink(
143 parameters, QStringLiteral( "ERRORS" ), context, dest_errors, fields, Qgis::WkbType::Point, input->sourceCrs()
144 ) );
145 if ( !sink_errors )
146 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "ERRORS" ) ) );
147
148 QgsProcessingMultiStepFeedback multiStepFeedback( 3, feedback );
149
150 const QgsProject *project = QgsProject::instance();
151 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), project->transformContext(), project );
152
153 // Test detection
154 QList<QgsGeometryCheckError *> checkErrors;
155 QStringList messages;
156
157 const QgsGeometryMultipartCheck check( &checkContext, QVariantMap() );
158
159 multiStepFeedback.setCurrentStep( 1 );
160 feedback->setProgressText( QObject::tr( "Preparing features…" ) );
161 QMap<QString, QgsFeaturePool *> featurePools;
162
163 std::unique_ptr<QgsVectorLayer> inputLayer( input->materialize( QgsFeatureRequest() ) );
165 featurePools.insert( inputLayer->id(), &featurePool );
166
167 multiStepFeedback.setCurrentStep( 2 );
168 feedback->setProgressText( QObject::tr( "Collecting errors…" ) );
169 check.collectErrors( featurePools, checkErrors, messages, feedback );
170
171 multiStepFeedback.setCurrentStep( 3 );
172 feedback->setProgressText( QObject::tr( "Exporting errors…" ) );
173 const double step { checkErrors.size() > 0 ? 100.0 / checkErrors.size() : 1 };
174 long i = 0;
175 feedback->setProgress( 0.0 );
176
177 for ( const QgsGeometryCheckError *error : checkErrors )
178 {
179 if ( feedback->isCanceled() )
180 break;
181
182 QgsFeature f;
183 QgsAttributes attrs = f.attributes();
184
185 attrs << error->layerId()
186 << inputLayer->name()
187 << error->vidx().part
188 << error->vidx().ring
189 << error->vidx().vertex
190 << error->location().x()
191 << error->location().y()
192 << error->value().toString()
193 << inputLayer->getFeature( error->featureId() ).attribute( uniqueIdField.name() );
194 f.setAttributes( attrs );
195
196 f.setGeometry( error->geometry() );
197 if ( !sink_output->addFeature( f, QgsFeatureSink::FastInsert ) )
198 throw QgsProcessingException( writeFeatureError( sink_output.get(), parameters, QStringLiteral( "OUTPUT" ) ) );
199
200 f.setGeometry( QgsGeometry::fromPoint( QgsPoint( error->location().x(), error->location().y() ) ) );
201 if ( !sink_errors->addFeature( f, QgsFeatureSink::FastInsert ) )
202 throw QgsProcessingException( writeFeatureError( sink_errors.get(), parameters, QStringLiteral( "ERRORS" ) ) );
203
204 i++;
205 feedback->setProgress( 100.0 * step * static_cast<double>( i ) );
206 }
207
208 QVariantMap outputs;
209 outputs.insert( QStringLiteral( "OUTPUT" ), dest_output );
210 outputs.insert( QStringLiteral( "ERRORS" ), dest_errors );
211
212 // Place the point layer above the other layer
213 if ( context.willLoadLayerOnCompletion( dest_output ) && context.willLoadLayerOnCompletion( dest_errors ) )
214 {
215 context.layerToLoadOnCompletionDetails( dest_errors ).layerSortKey = 0;
216 context.layerToLoadOnCompletionDetails( dest_output ).layerSortKey = 1;
217 }
218
219 return outputs;
220}
221
@ 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.