QGIS API Documentation 3.43.0-Master (e01d6d7c4c0)
qgsalgorithmcheckgeometrylinelayerintersection.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmcheckgeometrylinelayerintersection.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 QgsGeometryCheckLineLayerIntersectionAlgorithm::name() const
29{
30 return QStringLiteral( "checkgeometrylinelayerintersection" );
31}
32
33QString QgsGeometryCheckLineLayerIntersectionAlgorithm::displayName() const
34{
35 return QObject::tr( "Lines intersecting other layer" );
36}
37
38QString QgsGeometryCheckLineLayerIntersectionAlgorithm::shortDescription() const
39{
40 return QObject::tr( "Detects lines intersecting features from another layer." );
41}
42
43QStringList QgsGeometryCheckLineLayerIntersectionAlgorithm::tags() const
44{
45 return QObject::tr( "check,geometry,line,intersection" ).split( ',' );
46}
47
48QString QgsGeometryCheckLineLayerIntersectionAlgorithm::group() const
49{
50 return QObject::tr( "Check geometry" );
51}
52
53QString QgsGeometryCheckLineLayerIntersectionAlgorithm::groupId() const
54{
55 return QStringLiteral( "checkgeometry" );
56}
57
58QString QgsGeometryCheckLineLayerIntersectionAlgorithm::shortHelpString() const
59{
60 return QObject::tr( "This algorithm checks if the input line layer features intersect with the check layer features.\n"
61 "An input feature that intersects with a check layer feature is an error.\n" );
62}
63
64Qgis::ProcessingAlgorithmFlags QgsGeometryCheckLineLayerIntersectionAlgorithm::flags() const
65{
67}
68
69QgsGeometryCheckLineLayerIntersectionAlgorithm *QgsGeometryCheckLineLayerIntersectionAlgorithm::createInstance() const
70{
71 return new QgsGeometryCheckLineLayerIntersectionAlgorithm();
72}
73
74void QgsGeometryCheckLineLayerIntersectionAlgorithm::initAlgorithm( const QVariantMap &configuration )
75{
76 Q_UNUSED( configuration )
77
79 QStringLiteral( "INPUT" ), QObject::tr( "Input layer" ), QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorLine )
80 ) );
81 addParameter( new QgsProcessingParameterField(
82 QStringLiteral( "UNIQUE_ID" ), QObject::tr( "Unique feature identifier" ), QString(), QStringLiteral( "INPUT" )
83 ) );
85 QStringLiteral( "CHECK_LAYER" ), QObject::tr( "Check layer" ),
86 QList<int>()
87 << static_cast<int>( Qgis::ProcessingSourceType::VectorLine )
89 ) );
90 addParameter( new QgsProcessingParameterFeatureSink(
91 QStringLiteral( "ERRORS" ), QObject::tr( "Line intersecting other layer errors" ), Qgis::ProcessingSourceType::VectorPoint
92 ) );
93 addParameter( new QgsProcessingParameterFeatureSink(
94 QStringLiteral( "OUTPUT" ), QObject::tr( "Line intersecting other layer features" ), Qgis::ProcessingSourceType::VectorAnyGeometry, QVariant(), true, false
95 ) );
96
97 std::unique_ptr<QgsProcessingParameterNumber> tolerance = std::make_unique<QgsProcessingParameterNumber>(
98 QStringLiteral( "TOLERANCE" ), 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 QgsGeometryCheckLineLayerIntersectionAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
107{
108 mTolerance = parameterAsInt( parameters, QStringLiteral( "TOLERANCE" ), context );
109
110 return true;
111}
112
113QgsFields QgsGeometryCheckLineLayerIntersectionAlgorithm::outputFields()
114{
115 QgsFields fields;
116 fields.append( QgsField( QStringLiteral( "gc_layerid" ), QMetaType::QString ) );
117 fields.append( QgsField( QStringLiteral( "gc_layername" ), QMetaType::QString ) );
118 fields.append( QgsField( QStringLiteral( "gc_partidx" ), QMetaType::Int ) );
119 fields.append( QgsField( QStringLiteral( "gc_ringidx" ), QMetaType::Int ) );
120 fields.append( QgsField( QStringLiteral( "gc_vertidx" ), QMetaType::Int ) );
121 fields.append( QgsField( QStringLiteral( "gc_errorx" ), QMetaType::Double ) );
122 fields.append( QgsField( QStringLiteral( "gc_errory" ), QMetaType::Double ) );
123 fields.append( QgsField( QStringLiteral( "gc_error" ), QMetaType::QString ) );
124 return fields;
125}
126
127
128QVariantMap QgsGeometryCheckLineLayerIntersectionAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
129{
130 QString dest_output;
131 QString dest_errors;
132 const std::unique_ptr<QgsFeatureSource> input( parameterAsSource( parameters, QStringLiteral( "INPUT" ), context ) );
133 if ( !input )
134 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "INPUT" ) ) );
135
136 const QString uniqueIdFieldName( parameterAsString( parameters, QStringLiteral( "UNIQUE_ID" ), context ) );
137 const int uniqueIdFieldIdx = input->fields().indexFromName( uniqueIdFieldName );
138 if ( uniqueIdFieldIdx == -1 )
139 throw QgsProcessingException( QObject::tr( "Missing field %1 in input layer" ).arg( uniqueIdFieldName ) );
140
141 const QgsField uniqueIdField = input->fields().at( uniqueIdFieldIdx );
142
143 QgsFields fields = outputFields();
144 fields.append( uniqueIdField );
145
146 QgsFeatureSource *checkSource = parameterAsSource( parameters, QStringLiteral( "CHECK_LAYER" ), context );
147 if ( !checkSource )
148 throw QgsProcessingException( invalidSourceError( parameters, QStringLiteral( "CHECK_LAYER" ) ) );
149
150 const std::unique_ptr<QgsFeatureSink> sink_output( parameterAsSink(
151 parameters, QStringLiteral( "OUTPUT" ), context, dest_output, fields, input->wkbType(), input->sourceCrs()
152 ) );
153
154 const std::unique_ptr<QgsFeatureSink> sink_errors( parameterAsSink(
155 parameters, QStringLiteral( "ERRORS" ), context, dest_errors, fields, Qgis::WkbType::Point, input->sourceCrs()
156 ) );
157 if ( !sink_errors )
158 throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "ERRORS" ) ) );
159
160 QgsProcessingMultiStepFeedback multiStepFeedback( 3, feedback );
161
162 const QgsProject *project = QgsProject::instance();
163
164 QgsGeometryCheckContext checkContext = QgsGeometryCheckContext( mTolerance, input->sourceCrs(), project->transformContext(), project );
165
166 // Test detection
167 QVariantMap configurationCheck;
168 QList<QgsGeometryCheckError *> checkErrors;
169 QStringList messages;
170
171 multiStepFeedback.setCurrentStep( 1 );
172 feedback->setProgressText( QObject::tr( "Preparing features…" ) );
173 QMap<QString, QgsFeaturePool *> checkerFeaturePools;
174
175 std::unique_ptr<QgsVectorLayer> inputLayer( input->materialize( QgsFeatureRequest() ) );
176 QgsVectorDataProviderFeaturePool inputFeaturePool = QgsVectorDataProviderFeaturePool( inputLayer.get() );
177 checkerFeaturePools.insert( inputLayer->id(), &inputFeaturePool );
178
179 std::unique_ptr<QgsVectorLayer> checkLayer( checkSource->materialize( QgsFeatureRequest() ) );
180 QgsVectorDataProviderFeaturePool checkFeaturePool = QgsVectorDataProviderFeaturePool( checkLayer.get() );
181 checkerFeaturePools.insert( checkLayer->id(), &checkFeaturePool );
182
183 configurationCheck.insert( "checkLayer", checkLayer->id() );
184 const QgsGeometryLineLayerIntersectionCheck check( &checkContext, configurationCheck );
185
186 multiStepFeedback.setCurrentStep( 2 );
187 feedback->setProgressText( QObject::tr( "Collecting errors…" ) );
188 check.collectErrors( checkerFeaturePools, checkErrors, messages, feedback );
189
190 multiStepFeedback.setCurrentStep( 3 );
191 feedback->setProgressText( QObject::tr( "Exporting errors…" ) );
192 const double step { checkErrors.size() > 0 ? 100.0 / checkErrors.size() : 1 };
193 long i = 0;
194 feedback->setProgress( 0.0 );
195
196 for ( const QgsGeometryCheckError *error : checkErrors )
197 {
198 if ( feedback->isCanceled() )
199 {
200 break;
201 }
202 QgsFeature f;
203 QgsAttributes attrs = f.attributes();
204
205 attrs << error->layerId()
206 << inputLayer->name()
207 << error->vidx().part
208 << error->vidx().ring
209 << error->vidx().vertex
210 << error->location().x()
211 << error->location().y()
212 << error->value().toString()
213 << inputLayer->getFeature( error->featureId() ).attribute( uniqueIdField.name() );
214 f.setAttributes( attrs );
215
216 f.setGeometry( error->geometry() );
217 if ( sink_output && !sink_output->addFeature( f, QgsFeatureSink::FastInsert ) )
218 throw QgsProcessingException( writeFeatureError( sink_output.get(), parameters, QStringLiteral( "OUTPUT" ) ) );
219
220 f.setGeometry( QgsGeometry::fromPoint( QgsPoint( error->location().x(), error->location().y() ) ) );
221 if ( !sink_errors->addFeature( f, QgsFeatureSink::FastInsert ) )
222 throw QgsProcessingException( writeFeatureError( sink_errors.get(), parameters, QStringLiteral( "ERRORS" ) ) );
223
224 i++;
225 feedback->setProgress( 100.0 * step * static_cast<double>( i ) );
226 }
227
228 // cleanup memory of the pointed data
229 for ( const QgsGeometryCheckError *error : checkErrors )
230 {
231 delete error;
232 }
233
234 QVariantMap outputs;
235 if ( sink_output )
236 outputs.insert( QStringLiteral( "OUTPUT" ), dest_output );
237 outputs.insert( QStringLiteral( "ERRORS" ), dest_errors );
238
239 return outputs;
240}
241
@ 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...
An interface for objects which provide features via a getFeatures method.
QgsVectorLayer * materialize(const QgsFeatureRequest &request, QgsFeedback *feedback=nullptr)
Materializes a request (query) made against this feature source, by running it over the source and re...
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.
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.
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.