QGIS API Documentation 3.43.0-Master (c4a2e9c6d2f)
qgsalgorithmcheckgeometryselfintersection.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmcheckgeometryselfintersection.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 QgsGeometryCheckSelfIntersectionAlgorithm::name() const
29{
30 return QStringLiteral( "checkgeometryselfintersection" );
31}
32
33QString QgsGeometryCheckSelfIntersectionAlgorithm::displayName() const
34{
35 return QObject::tr( "Check Geometry (Self intersection)" );
36}
37
38QStringList QgsGeometryCheckSelfIntersectionAlgorithm::tags() const
39{
40 return QObject::tr( "check,geometry,intersection" ).split( ',' );
41}
42
43QString QgsGeometryCheckSelfIntersectionAlgorithm::group() const
44{
45 return QObject::tr( "Check geometry" );
46}
47
48QString QgsGeometryCheckSelfIntersectionAlgorithm::groupId() const
49{
50 return QStringLiteral( "checkgeometry" );
51}
52
53QString QgsGeometryCheckSelfIntersectionAlgorithm::shortHelpString() const
54{
55 return QObject::tr( "This algorithm checks self-intersecting geometries.\n"
56 "Self-intersecting geometries are errors." );
57}
58
59Qgis::ProcessingAlgorithmFlags QgsGeometryCheckSelfIntersectionAlgorithm::flags() const
60{
62}
63
64QgsGeometryCheckSelfIntersectionAlgorithm *QgsGeometryCheckSelfIntersectionAlgorithm::createInstance() const
65{
66 return new QgsGeometryCheckSelfIntersectionAlgorithm();
67}
68
69void QgsGeometryCheckSelfIntersectionAlgorithm::initAlgorithm( const QVariantMap &configuration )
70{
71 Q_UNUSED( configuration )
72
74 QStringLiteral( "INPUT" ), QObject::tr( "Input layer" ),
75 QList<int>()
77 << static_cast<int>( Qgis::ProcessingSourceType::VectorLine )
78 ) );
79 addParameter( new QgsProcessingParameterField(
80 QStringLiteral( "UNIQUE_ID" ), QObject::tr( "Unique feature identifier" ), QString(), QStringLiteral( "INPUT" )
81 ) );
82 addParameter( new QgsProcessingParameterFeatureSink(
83 QStringLiteral( "ERRORS" ), QObject::tr( "Errors layer" ), Qgis::ProcessingSourceType::VectorPoint
84 ) );
85 addParameter( new QgsProcessingParameterFeatureSink(
86 QStringLiteral( "OUTPUT" ), QObject::tr( "Output layer" ), Qgis::ProcessingSourceType::VectorAnyGeometry
87 ) );
88
89 std::unique_ptr<QgsProcessingParameterNumber> tolerance = std::make_unique<QgsProcessingParameterNumber>(
90 QStringLiteral( "TOLERANCE" ), QObject::tr( "Tolerance" ), Qgis::ProcessingNumberParameterType::Integer, 8, false, 1, 13
91 );
92 tolerance->setFlags( tolerance->flags() | Qgis::ProcessingParameterFlag::Advanced );
93 addParameter( tolerance.release() );
94}
95
96bool QgsGeometryCheckSelfIntersectionAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
97{
98 mTolerance = parameterAsInt( parameters, QStringLiteral( "TOLERANCE" ), context );
99
100 return true;
101}
102
103QgsFields QgsGeometryCheckSelfIntersectionAlgorithm::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 fields.append( QgsField( QStringLiteral( "gc_segment_1" ), QMetaType::Int ) );
115 fields.append( QgsField( QStringLiteral( "gc_segment_2" ), QMetaType::Int ) );
116 return fields;
117}
118
119
120QVariantMap QgsGeometryCheckSelfIntersectionAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
121{
122 QString dest_output;
123 QString dest_errors;
124 const std::unique_ptr<QgsProcessingFeatureSource> input( parameterAsSource( parameters, QStringLiteral( "INPUT" ), context ) );
125 if ( !input )
126 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "INPUT" ) ) );
127
128 const QString uniqueIdFieldName( parameterAsString( parameters, QStringLiteral( "UNIQUE_ID" ), context ) );
129 const int uniqueIdFieldIdx = input->fields().indexFromName( uniqueIdFieldName );
130 if ( uniqueIdFieldIdx == -1 )
131 throw QgsProcessingException( QObject::tr( "Missing field %1 in input layer" ).arg( uniqueIdFieldName ) );
132
133 const QgsField uniqueIdField = input->fields().at( uniqueIdFieldIdx );
134
135 QgsFields fields = outputFields();
136 fields.append( uniqueIdField );
137
138 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
139 parameters, QStringLiteral( "OUTPUT" ), context, dest_output, fields, input->wkbType(), input->sourceCrs()
140 ) );
141 if ( !sink_output )
142 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "OUTPUT" ) ) );
143
144 const std::unique_ptr<QgsFeatureSink> sink_errors( parameterAsSink(
145 parameters, QStringLiteral( "ERRORS" ), context, dest_errors, fields, Qgis::WkbType::Point, input->sourceCrs()
146 ) );
147 if ( !sink_errors )
148 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "ERRORS" ) ) );
149
150 QgsProcessingMultiStepFeedback multiStepFeedback( 3, feedback );
151
152 const QgsProject *project = QgsProject::instance();
153
154 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), project->transformContext(), project );
155
156 // Test detection
157 QList<QgsGeometryCheckError *> checkErrors;
158 QStringList messages;
159
160 const QgsGeometrySelfIntersectionCheck check( &checkContext, QVariantMap() );
161
162 multiStepFeedback.setCurrentStep( 1 );
163 feedback->setProgressText( QObject::tr( "Preparing features…" ) );
164 QMap<QString, QgsFeaturePool *> featurePools;
165
166 std::unique_ptr<QgsVectorLayer> inputLayer( input->materialize( QgsFeatureRequest() ) );
168 featurePools.insert( inputLayer->id(), &featurePool );
169
170 multiStepFeedback.setCurrentStep( 2 );
171 feedback->setProgressText( QObject::tr( "Collecting errors…" ) );
172 check.collectErrors( featurePools, checkErrors, messages, feedback );
173
174 multiStepFeedback.setCurrentStep( 3 );
175 feedback->setProgressText( QObject::tr( "Exporting errors…" ) );
176 const double step { checkErrors.size() > 0 ? 100.0 / checkErrors.size() : 1 };
177 long i = 0;
178 feedback->setProgress( 0.0 );
179
180 for ( QgsGeometryCheckError *error : checkErrors )
181 {
182 const QgsGeometryCheckErrorSingle *singleError = dynamic_cast<const QgsGeometryCheckErrorSingle *>( error );
183 if ( !singleError )
184 break;
185
186 const QgsGeometrySelfIntersectionCheckError *selfIntersectionError = dynamic_cast<const QgsGeometrySelfIntersectionCheckError *>( singleError->singleError() );
187 if ( !selfIntersectionError )
188 break;
189
190 const QgsGeometryUtils::SelfIntersection &intersection = selfIntersectionError->intersection();
191
192 if ( feedback->isCanceled() )
193 break;
194
195 QgsFeature f;
196 QgsAttributes attrs = f.attributes();
197
198 attrs << error->layerId()
199 << inputLayer->name()
200 << error->vidx().part
201 << error->vidx().ring
202 << error->vidx().vertex
203 << error->location().x()
204 << error->location().y()
205 << error->value().toString()
206 << intersection.segment1
207 << intersection.segment2
208 << inputLayer->getFeature( error->featureId() ).attribute( uniqueIdField.name() );
209 f.setAttributes( attrs );
210
211 f.setGeometry( error->geometry() );
212 if ( !sink_output->addFeature( f, QgsFeatureSink::FastInsert ) )
213 throw QgsProcessingException( writeFeatureError( sink_output.get(), parameters, QStringLiteral( "OUTPUT" ) ) );
214
215 f.setGeometry( QgsGeometry::fromPoint( QgsPoint( error->location().x(), error->location().y() ) ) );
216 if ( !sink_errors->addFeature( f, QgsFeatureSink::FastInsert ) )
217 throw QgsProcessingException( writeFeatureError( sink_errors.get(), parameters, QStringLiteral( "ERRORS" ) ) );
218
219 i++;
220 feedback->setProgress( 100.0 * step * static_cast<double>( i ) );
221 }
222
223 // Place the point layer above the other layer
224 if ( context.willLoadLayerOnCompletion( dest_output ) && context.willLoadLayerOnCompletion( dest_errors ) )
225 {
226 context.layerToLoadOnCompletionDetails( dest_errors ).layerSortKey = 0;
227 context.layerToLoadOnCompletionDetails( dest_output ).layerSortKey = 1;
228 }
229
230 QVariantMap outputs;
231 outputs.insert( QStringLiteral( "OUTPUT" ), dest_output );
232 outputs.insert( QStringLiteral( "ERRORS" ), dest_errors );
233
234 return outputs;
235}
236
@ 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.
Wraps a QgsSingleGeometryError into a standard QgsGeometryCheckError.
QgsSingleGeometryCheckError * singleError() const
The underlying single error.
This represents an error reported by a geometry check.
const QgsGeometryUtils::SelfIntersection & intersection() const
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.