QGIS API Documentation 3.43.0-Master (e01d6d7c4c0)
qgsalgorithmremoveduplicatevertices.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmremoveduplicatevertices.cpp
3 ---------------------
4 begin : November 2017
5 copyright : (C) 2017 by Nyall Dawson
6 email : nyall dot dawson at gmail 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
19
21
22QString QgsAlgorithmRemoveDuplicateVertices::name() const
23{
24 return QStringLiteral( "removeduplicatevertices" );
25}
26
27QString QgsAlgorithmRemoveDuplicateVertices::displayName() const
28{
29 return QObject::tr( "Remove duplicate vertices" );
30}
31
32QStringList QgsAlgorithmRemoveDuplicateVertices::tags() const
33{
34 return QObject::tr( "points,valid,overlapping,vertex,nodes,invalid,error,repair" ).split( ',' );
35}
36
37QString QgsAlgorithmRemoveDuplicateVertices::group() const
38{
39 return QObject::tr( "Vector geometry" );
40}
41
42QString QgsAlgorithmRemoveDuplicateVertices::groupId() const
43{
44 return QStringLiteral( "vectorgeometry" );
45}
46
47QString QgsAlgorithmRemoveDuplicateVertices::outputName() const
48{
49 return QObject::tr( "Cleaned" );
50}
51
52QString QgsAlgorithmRemoveDuplicateVertices::shortHelpString() const
53{
54 return QObject::tr( "This algorithm removes duplicate vertices from features, wherever removing the vertices does "
55 "not result in a degenerate geometry.\n\n"
56 "The tolerance parameter specifies the tolerance for coordinates when determining whether "
57 "vertices are identical.\n\n"
58 "By default, z values are not considered when detecting duplicate vertices. E.g. two vertices "
59 "with the same x and y coordinate but different z values will still be considered "
60 "duplicate and one will be removed. If the Use Z Value parameter is true, then the z values are "
61 "also tested and vertices with the same x and y but different z will be maintained.\n\n"
62 "Note that duplicate vertices are not tested between different parts of a multipart geometry. E.g. "
63 "a multipoint geometry with overlapping points will not be changed by this method." );
64}
65
66QString QgsAlgorithmRemoveDuplicateVertices::shortDescription() const
67{
68 return QObject::tr( "Removes duplicate vertices from features, wherever removing the vertices does "
69 "not result in a degenerate geometry." );
70}
71
72QgsAlgorithmRemoveDuplicateVertices *QgsAlgorithmRemoveDuplicateVertices::createInstance() const
73{
74 return new QgsAlgorithmRemoveDuplicateVertices();
75}
76
77void QgsAlgorithmRemoveDuplicateVertices::initParameters( const QVariantMap & )
78{
79 auto tolerance = std::make_unique<QgsProcessingParameterDistance>( QStringLiteral( "TOLERANCE" ), QObject::tr( "Tolerance" ), 0.000001, QStringLiteral( "INPUT" ), false, 0, 10000000.0 );
80 tolerance->setIsDynamic( true );
81 tolerance->setDynamicPropertyDefinition( QgsPropertyDefinition( QStringLiteral( "Tolerance" ), QObject::tr( "Tolerance distance" ), QgsPropertyDefinition::DoublePositive ) );
82 tolerance->setDynamicLayerParameterName( QStringLiteral( "INPUT" ) );
83 addParameter( tolerance.release() );
84
85 auto useZ = std::make_unique<QgsProcessingParameterBoolean>( QStringLiteral( "USE_Z_VALUE" ), QObject::tr( "Use Z Value" ), false );
86 useZ->setIsDynamic( true );
87 useZ->setDynamicPropertyDefinition( QgsPropertyDefinition( QStringLiteral( "UseZ" ), QObject::tr( "Use Z Value" ), QgsPropertyDefinition::Boolean ) );
88 useZ->setDynamicLayerParameterName( QStringLiteral( "INPUT" ) );
89 addParameter( useZ.release() );
90}
91
92Qgis::ProcessingFeatureSourceFlags QgsAlgorithmRemoveDuplicateVertices::sourceFlags() const
93{
94 // skip geometry checks - this algorithm can be used to repair geometries
96}
97
98bool QgsAlgorithmRemoveDuplicateVertices::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
99{
100 mTolerance = parameterAsDouble( parameters, QStringLiteral( "TOLERANCE" ), context );
101 mDynamicTolerance = QgsProcessingParameters::isDynamic( parameters, QStringLiteral( "TOLERANCE" ) );
102 if ( mDynamicTolerance )
103 mToleranceProperty = parameters.value( QStringLiteral( "TOLERANCE" ) ).value<QgsProperty>();
104
105 mUseZValues = parameterAsBoolean( parameters, QStringLiteral( "USE_Z_VALUE" ), context );
106 mDynamicUseZ = QgsProcessingParameters::isDynamic( parameters, QStringLiteral( "USE_Z_VALUE" ) );
107 if ( mDynamicUseZ )
108 mUseZProperty = parameters.value( QStringLiteral( "USE_Z_VALUE" ) ).value<QgsProperty>();
109
110 return true;
111}
112
113QgsFeatureList QgsAlgorithmRemoveDuplicateVertices::processFeature( const QgsFeature &feature, QgsProcessingContext &context, QgsProcessingFeedback * )
114{
115 QgsFeature f = feature;
116 if ( f.hasGeometry() )
117 {
118 QgsGeometry geometry = f.geometry();
119 double tolerance = mTolerance;
120 if ( mDynamicTolerance )
121 tolerance = mToleranceProperty.valueAsDouble( context.expressionContext(), tolerance );
122
123 bool useZValue = mUseZValues;
124 if ( mDynamicUseZ )
125 useZValue = mUseZProperty.valueAsBool( context.expressionContext(), useZValue );
126
127 geometry.removeDuplicateNodes( tolerance, useZValue );
128 f.setGeometry( geometry );
129 }
130 return QgsFeatureList() << f;
131}
132
@ SkipGeometryValidityChecks
Invalid geometry checks should always be skipped. This flag can be useful for algorithms which always...
QFlags< ProcessingFeatureSourceFlag > ProcessingFeatureSourceFlags
Flags which control how QgsProcessingFeatureSource fetches features.
Definition qgis.h:3588
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
QgsGeometry geometry
Definition qgsfeature.h:69
bool hasGeometry() const
Returns true if the feature has an associated geometry.
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
A geometry is the spatial representation of a feature.
bool removeDuplicateNodes(double epsilon=4 *std::numeric_limits< double >::epsilon(), bool useZValues=false)
Removes duplicate nodes from the geometry, wherever removing the nodes does not result in a degenerat...
Contains information about the context in which a processing algorithm is executed.
QgsExpressionContext & expressionContext()
Returns the expression context.
Base class for providing feedback from a processing algorithm.
static bool isDynamic(const QVariantMap &parameters, const QString &name)
Returns true if the parameter with matching name is a dynamic parameter, and must be evaluated once f...
Definition for a property.
Definition qgsproperty.h:45
@ Boolean
Boolean value.
Definition qgsproperty.h:51
@ DoublePositive
Positive double value (including 0)
Definition qgsproperty.h:56
A store for object properties.
bool valueAsBool(const QgsExpressionContext &context, bool defaultValue=false, bool *ok=nullptr) const
Calculates the current value of the property and interprets it as an boolean.
QList< QgsFeature > QgsFeatureList