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