QGIS API Documentation 3.99.0-Master (2fe06baccd8)
Loading...
Searching...
No Matches
qgsalgorithmmultiringconstantbuffer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmnultitingconstantbuffer.cpp
3 --------------------------
4 begin : February 2018
5 copyright : (C) 2018 by Alexander Bruy
6 email : alexander dot bruy 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
20#include "qgsvectorlayer.h"
21
23
24QString QgsMultiRingConstantBufferAlgorithm::name() const
25{
26 return QStringLiteral( "multiringconstantbuffer" );
27}
28
29QString QgsMultiRingConstantBufferAlgorithm::displayName() const
30{
31 return QObject::tr( "Multi-ring buffer (constant distance)" );
32}
33
34QStringList QgsMultiRingConstantBufferAlgorithm::tags() const
35{
36 return QObject::tr( "buffer,grow,multiple,rings,distance,donut" ).split( ',' );
37}
38
39QString QgsMultiRingConstantBufferAlgorithm::group() const
40{
41 return QObject::tr( "Vector geometry" );
42}
43
44QString QgsMultiRingConstantBufferAlgorithm::groupId() const
45{
46 return QStringLiteral( "vectorgeometry" );
47}
48
49QString QgsMultiRingConstantBufferAlgorithm::outputName() const
50{
51 return QObject::tr( "Multi-ring buffer (constant distance)" );
52}
53
54QString QgsMultiRingConstantBufferAlgorithm::shortHelpString() const
55{
56 return QObject::tr( "This algorithm computes multi-ring ('donuts') buffer for the features in an input layer, using a fixed or dynamic distance and number of rings." );
57}
58
59QString QgsMultiRingConstantBufferAlgorithm::shortDescription() const
60{
61 return QObject::tr( "Computes multi-ring ('donuts') buffer using a fixed or dynamic distance and number of rings." );
62}
63
64Qgis::ProcessingAlgorithmDocumentationFlags QgsMultiRingConstantBufferAlgorithm::documentationFlags() const
65{
67}
68
69QgsMultiRingConstantBufferAlgorithm *QgsMultiRingConstantBufferAlgorithm::createInstance() const
70{
71 return new QgsMultiRingConstantBufferAlgorithm();
72}
73
74void QgsMultiRingConstantBufferAlgorithm::initParameters( const QVariantMap & )
75{
76 auto rings = std::make_unique<QgsProcessingParameterNumber>( QStringLiteral( "RINGS" ), QObject::tr( "Number of rings" ), Qgis::ProcessingNumberParameterType::Integer, 1, false, 0 );
77 rings->setIsDynamic( true );
78 rings->setDynamicPropertyDefinition( QgsPropertyDefinition( QStringLiteral( "RINGS" ), QObject::tr( "Number of rings" ), QgsPropertyDefinition::IntegerPositive ) );
79 rings->setDynamicLayerParameterName( QStringLiteral( "INPUT" ) );
80 addParameter( rings.release() );
81
82 auto distance = std::make_unique<QgsProcessingParameterDistance>( QStringLiteral( "DISTANCE" ), QObject::tr( "Distance between rings" ), 1, QStringLiteral( "INPUT" ), false );
83 distance->setIsDynamic( true );
84 distance->setDynamicPropertyDefinition( QgsPropertyDefinition( QStringLiteral( "DISTANCE" ), QObject::tr( "Distance between rings" ), QgsPropertyDefinition::DoublePositive ) );
85 distance->setDynamicLayerParameterName( QStringLiteral( "INPUT" ) );
86 addParameter( distance.release() );
87}
88
89bool QgsMultiRingConstantBufferAlgorithm::supportInPlaceEdit( const QgsMapLayer *l ) const
90{
91 const QgsVectorLayer *layer = qobject_cast<const QgsVectorLayer *>( l );
92 if ( !layer )
93 return false;
94
96 return false;
97 // Polygons only
98 return layer->wkbType() == Qgis::WkbType::Polygon || layer->wkbType() == Qgis::WkbType::MultiPolygon;
99}
100
101bool QgsMultiRingConstantBufferAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
102{
103 mRingsNumber = parameterAsInt( parameters, QStringLiteral( "RINGS" ), context );
104 mDynamicRingsNumber = QgsProcessingParameters::isDynamic( parameters, QStringLiteral( "RINGS" ) );
105 if ( mDynamicRingsNumber )
106 mRingsNumberProperty = parameters.value( QStringLiteral( "RINGS" ) ).value<QgsProperty>();
107
108 mDistance = parameterAsDouble( parameters, QStringLiteral( "DISTANCE" ), context );
109 mDynamicDistance = QgsProcessingParameters::isDynamic( parameters, QStringLiteral( "DISTANCE" ) );
110 if ( mDynamicDistance )
111 mDistanceProperty = parameters.value( QStringLiteral( "DISTANCE" ) ).value<QgsProperty>();
112
113 return true;
114}
115
116QgsFields QgsMultiRingConstantBufferAlgorithm::outputFields( const QgsFields &inputFields ) const
117{
118 QgsFields newFields;
119 newFields.append( QgsField( QStringLiteral( "ringId" ), QMetaType::Type::Int, QString(), 10, 0 ) );
120 newFields.append( QgsField( QStringLiteral( "distance" ), QMetaType::Type::Double, QString(), 20, 6 ) );
121 return QgsProcessingUtils::combineFields( inputFields, newFields );
122}
123
124Qgis::ProcessingFeatureSourceFlags QgsMultiRingConstantBufferAlgorithm::sourceFlags() const
125{
127}
128
129QgsFeatureSink::SinkFlags QgsMultiRingConstantBufferAlgorithm::sinkFlags() const
130{
132}
133
134QgsFeatureList QgsMultiRingConstantBufferAlgorithm::processFeature( const QgsFeature &feature, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
135{
136 double currentDistance = 0;
137 QgsGeometry outputGeometry, previousGeometry;
138
139 int rings = mRingsNumber;
140 if ( mDynamicRingsNumber )
141 rings = mRingsNumberProperty.valueAsInt( context.expressionContext(), rings );
142
143 double distance = mDistance;
144 if ( mDynamicDistance )
145 distance = mDistanceProperty.valueAsDouble( context.expressionContext(), distance );
146
147 QgsFeatureList outputs;
148
149 // Set previous geometry to a zero-distance buffer of the original geometry,
150 // this is needed for negative distance values
151 previousGeometry = feature.geometry().buffer( 0.0, 40 );
152 previousGeometry.convertToMultiType();
153
154 for ( int i = 1; i <= rings; ++i )
155 {
156 QgsFeature out;
157 currentDistance = i * distance;
158 outputGeometry = feature.geometry().buffer( currentDistance, 40 );
159 outputGeometry.convertToMultiType();
160 if ( outputGeometry.isNull() )
161 {
162 feedback->reportError( QObject::tr( "Error calculating buffer for feature %1" ).arg( feature.id() ) );
163 continue;
164 }
165
166 if ( distance < 0.0 )
167 {
168 out.setGeometry( previousGeometry.symDifference( outputGeometry ) );
169 }
170 else if ( i == 1 )
171 {
172 out.setGeometry( outputGeometry );
173 }
174 else
175 {
176 out.setGeometry( outputGeometry.symDifference( previousGeometry ) );
177 }
178 previousGeometry = outputGeometry;
179 QgsAttributes attrs = feature.attributes();
180 attrs << i << currentDistance;
181 out.setAttributes( attrs );
182 outputs.append( out );
183 }
184
185 // For negative distance values, the last generated buffer geometry needs to be added
186 if ( distance < 0.0 )
187 {
188 QgsFeature out;
189 out.setGeometry( previousGeometry );
190 QgsAttributes attrs = feature.attributes();
191 attrs << 0 << 0.0;
192 out.setAttributes( attrs );
193 outputs.append( out );
194 }
195
196 return outputs;
197}
198
@ RegeneratesPrimaryKey
Algorithm always drops any existing primary keys or FID values and regenerates them in outputs.
Definition qgis.h:3619
QFlags< ProcessingAlgorithmDocumentationFlag > ProcessingAlgorithmDocumentationFlags
Flags describing algorithm behavior for documentation purposes.
Definition qgis.h:3630
@ SkipGeometryValidityChecks
Invalid geometry checks should always be skipped. This flag can be useful for algorithms which always...
Definition qgis.h:3711
@ Polygon
Polygon.
Definition qgis.h:281
@ MultiPolygon
MultiPolygon.
Definition qgis.h:285
QFlags< ProcessingFeatureSourceFlag > ProcessingFeatureSourceFlags
Flags which control how QgsProcessingFeatureSource fetches features.
Definition qgis.h:3722
A vector of attributes.
QFlags< SinkFlag > SinkFlags
@ RegeneratePrimaryKey
This flag indicates, that a primary key field cannot be guaranteed to be unique and the sink should i...
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
QgsFeatureId id
Definition qgsfeature.h:66
void setAttributes(const QgsAttributes &attrs)
Sets the feature's attributes.
QgsGeometry geometry
Definition qgsfeature.h:69
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
Encapsulate a field in an attribute table or data source.
Definition qgsfield.h:54
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:73
A geometry is the spatial representation of a feature.
QgsGeometry symDifference(const QgsGeometry &geometry, const QgsGeometryParameters &parameters=QgsGeometryParameters()) const
Returns a geometry representing the points making up this geometry that do not make up other.
QgsGeometry buffer(double distance, int segments) const
Returns a buffer region around this geometry having the given width and with a specified number of se...
bool convertToMultiType()
Converts single type geometry into multitype geometry e.g.
Base class for all map layer types.
Definition qgsmaplayer.h:80
Contains information about the context in which a processing algorithm is executed.
QgsExpressionContext & expressionContext()
Returns the expression context.
bool supportInPlaceEdit(const QgsMapLayer *layer) const override
Checks whether this algorithm supports in-place editing on the given layer Default implementation for...
Base class for providing feedback from a processing algorithm.
virtual void reportError(const QString &error, bool fatalError=false)
Reports that the algorithm encountered an error while executing.
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...
static QgsFields combineFields(const QgsFields &fieldsA, const QgsFields &fieldsB, const QString &fieldsBPrefix=QString())
Combines two field lists, avoiding duplicate field names (in a case-insensitive manner).
Definition for a property.
Definition qgsproperty.h:45
@ IntegerPositive
Positive integer values (including 0).
Definition qgsproperty.h:53
@ DoublePositive
Positive double value (including 0).
Definition qgsproperty.h:56
A store for object properties.
double valueAsDouble(const QgsExpressionContext &context, double defaultValue=0.0, bool *ok=nullptr) const
Calculates the current value of the property and interprets it as a double.
Represents a vector layer which manages a vector based dataset.
Q_INVOKABLE Qgis::WkbType wkbType() const final
Returns the WKBType or WKBUnknown in case of error.
QList< QgsFeature > QgsFeatureList