QGIS API Documentation 4.1.0-Master (5bf3c20f3c9)
Loading...
Searching...
No Matches
qgsalgorithmpointsinpolygon.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmpointsinpolygon.cpp
3 ---------------------
4 begin : November 2019
5 copyright : (C) 2019 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
20#include "qgsapplication.h"
21#include "qgsgeometryengine.h"
22#include "qgsprocessing.h"
23#include "qgsvectorlayer.h"
24
25#include <QString>
26
27using namespace Qt::StringLiterals;
28
30
31void QgsPointsInPolygonAlgorithm::initParameters( const QVariantMap &configuration )
32{
33 mIsInPlace = configuration.value( u"IN_PLACE"_s ).toBool();
34
35 addParameter( new QgsProcessingParameterFeatureSource( u"POINTS"_s, QObject::tr( "Points" ), QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPoint ) ) );
36 addParameter( new QgsProcessingParameterField( u"WEIGHT"_s, QObject::tr( "Weight field" ), QVariant(), u"POINTS"_s, Qgis::ProcessingFieldParameterDataType::Any, false, true ) );
37 addParameter( new QgsProcessingParameterField( u"CLASSFIELD"_s, QObject::tr( "Class field" ), QVariant(), u"POINTS"_s, Qgis::ProcessingFieldParameterDataType::Any, false, true ) );
38 if ( mIsInPlace )
39 {
40 addParameter( new QgsProcessingParameterField( u"FIELD"_s, QObject::tr( "Count field" ), u"NUMPOINTS"_s, inputParameterName() ) );
41 }
42 else
43 {
44 addParameter( new QgsProcessingParameterString( u"FIELD"_s, QObject::tr( "Count field name" ), u"NUMPOINTS"_s ) );
45 }
46}
47
48QString QgsPointsInPolygonAlgorithm::name() const
49{
50 return u"countpointsinpolygon"_s;
51}
52
53QString QgsPointsInPolygonAlgorithm::displayName() const
54{
55 return QObject::tr( "Count points in polygon" );
56}
57
58QStringList QgsPointsInPolygonAlgorithm::tags() const
59{
60 return QObject::tr( "extract,filter,intersects,intersecting,disjoint,touching,within,contains,overlaps,relation" ).split( ',' );
61}
62
63QString QgsPointsInPolygonAlgorithm::svgIconPath() const
64{
65 return QgsApplication::iconPath( u"/algorithms/mAlgorithmSumPoints.svg"_s );
66}
67
68QIcon QgsPointsInPolygonAlgorithm::icon() const
69{
70 return QgsApplication::getThemeIcon( u"/algorithms/mAlgorithmSumPoints.svg"_s );
71}
72
73QString QgsPointsInPolygonAlgorithm::group() const
74{
75 return QObject::tr( "Vector analysis" );
76}
77
78QString QgsPointsInPolygonAlgorithm::groupId() const
79{
80 return u"vectoranalysis"_s;
81}
82
83QString QgsPointsInPolygonAlgorithm::shortHelpString() const
84{
85 return QObject::tr(
86 "This algorithm takes a points layer and a polygon layer and counts the number of points from "
87 "the first one in each polygons of the second one.\n\n"
88 "A new polygons layer is generated, with the exact same content as the input polygons layer, but "
89 "containing an additional field with the points count corresponding to each polygon.\n\n"
90 "An optional weight field can be used to assign weights to each point. If set, the count generated "
91 "will be the sum of the weight field for each point contained by the polygon.\n\n"
92 "Alternatively, a unique class field can be specified. If set, points are classified based on "
93 "the selected attribute, and if several points with the same attribute value are within the polygon, "
94 "only one of them is counted. The final count of the point in a polygon is, therefore, the count of "
95 "different classes that are found in it.\n\n"
96 "Both the weight field and unique class field cannot be specified. If they are, the weight field will "
97 "take precedence and the unique class field will be ignored."
98 );
99}
100
101QString QgsPointsInPolygonAlgorithm::shortDescription() const
102{
103 return QObject::tr( "Counts point features located within polygon features." );
104}
105
106QgsPointsInPolygonAlgorithm *QgsPointsInPolygonAlgorithm::createInstance() const
107{
108 return new QgsPointsInPolygonAlgorithm();
109}
110
111QList<int> QgsPointsInPolygonAlgorithm::inputLayerTypes() const
112{
113 return QList<int>() << static_cast<int>( Qgis::ProcessingSourceType::VectorPolygon );
114}
115
116Qgis::ProcessingSourceType QgsPointsInPolygonAlgorithm::outputLayerType() const
117{
119}
120
121QgsCoordinateReferenceSystem QgsPointsInPolygonAlgorithm::outputCrs( const QgsCoordinateReferenceSystem &inputCrs ) const
122{
123 mCrs = inputCrs;
124 return mCrs;
125}
126
127QString QgsPointsInPolygonAlgorithm::inputParameterName() const
128{
129 return u"POLYGONS"_s;
130}
131
132QString QgsPointsInPolygonAlgorithm::inputParameterDescription() const
133{
134 return QObject::tr( "Polygons" );
135}
136
137QString QgsPointsInPolygonAlgorithm::outputName() const
138{
139 return QObject::tr( "Count" );
140}
141
142bool QgsPointsInPolygonAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
143{
144 mFieldName = parameterAsString( parameters, u"FIELD"_s, context );
145 mWeightFieldName = parameterAsString( parameters, u"WEIGHT"_s, context );
146 mClassFieldName = parameterAsString( parameters, u"CLASSFIELD"_s, context );
147 mPointSource.reset( parameterAsSource( parameters, u"POINTS"_s, context ) );
148 if ( !mPointSource )
149 throw QgsProcessingException( invalidSourceError( parameters, u"POINTS"_s ) );
150
151 if ( !mWeightFieldName.isEmpty() )
152 {
153 mWeightFieldIndex = mPointSource->fields().lookupField( mWeightFieldName );
154 if ( mWeightFieldIndex == -1 )
155 throw QgsProcessingException( QObject::tr( "Could not find field %1" ).arg( mWeightFieldName ) );
156 mPointAttributes.append( mWeightFieldIndex );
157 }
158
159 if ( !mClassFieldName.isEmpty() )
160 {
161 mClassFieldIndex = mPointSource->fields().lookupField( mClassFieldName );
162 if ( mClassFieldIndex == -1 )
163 throw QgsProcessingException( QObject::tr( "Could not find field %1" ).arg( mClassFieldIndex ) );
164 mPointAttributes.append( mClassFieldIndex );
165 }
166
167 if ( mPointSource->hasSpatialIndex() == Qgis::SpatialIndexPresence::NotPresent )
168 feedback->pushWarning( QObject::tr( "No spatial index exists for points layer, performance will be severely degraded" ) );
169
170 return true;
171}
172
173QgsFeatureList QgsPointsInPolygonAlgorithm::processFeature( const QgsFeature &feature, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
174{
175 QgsFeature outputFeature = feature;
176 if ( !feature.hasGeometry() )
177 {
178 QgsAttributes attrs = feature.attributes();
179 if ( mDestFieldIndex < 0 )
180 attrs.append( 0 );
181 else
182 attrs[mDestFieldIndex] = 0;
183 outputFeature.setAttributes( attrs );
184 return QList<QgsFeature>() << outputFeature;
185 }
186 else
187 {
188 const QgsGeometry polyGeom = feature.geometry();
189 std::unique_ptr<QgsGeometryEngine> engine( QgsGeometry::createGeometryEngine( polyGeom.constGet() ) );
190 engine->prepareGeometry();
191
192 double count = 0;
193 QSet<QVariant> classes;
194
196 req.setSubsetOfAttributes( mPointAttributes );
197 QgsFeatureIterator it = mPointSource->getFeatures( req );
198
199 bool ok = false;
200 QgsFeature pointFeature;
201 while ( it.nextFeature( pointFeature ) )
202 {
203 if ( feedback->isCanceled() )
204 break;
205
206 if ( engine->contains( pointFeature.geometry().constGet() ) )
207 {
208 if ( mWeightFieldIndex >= 0 )
209 {
210 const QVariant weight = pointFeature.attribute( mWeightFieldIndex );
211 const double pointWeight = weight.toDouble( &ok );
212 // Ignore fields with non-numeric values
213 if ( ok )
214 count += pointWeight;
215 else
216 feedback->reportError( QObject::tr( "Weight field value “%1” is not a numeric value" ).arg( weight.toString() ) );
217 }
218 else if ( mClassFieldIndex >= 0 )
219 {
220 const QVariant pointClass = pointFeature.attribute( mClassFieldIndex );
221 classes.insert( pointClass );
222 }
223 else
224 {
225 count++;
226 }
227 }
228 }
229
230 QgsAttributes attrs = feature.attributes();
231 double score = 0;
232
233 if ( mClassFieldIndex >= 0 )
234 score = classes.size();
235 else
236 score = count;
237
238 if ( mDestFieldIndex < 0 )
239 attrs.append( score );
240 else
241 attrs[mDestFieldIndex] = score;
242
243 outputFeature.setAttributes( attrs );
244 return QList<QgsFeature>() << outputFeature;
245 }
246}
247
248QgsFields QgsPointsInPolygonAlgorithm::outputFields( const QgsFields &inputFields ) const
249{
250 if ( mIsInPlace )
251 {
252 mDestFieldIndex = inputFields.lookupField( mFieldName );
253 return inputFields;
254 }
255 else
256 {
257 QgsFields outFields = inputFields;
258 mDestFieldIndex = inputFields.lookupField( mFieldName );
259 if ( mDestFieldIndex < 0 )
260 outFields.append( QgsField( mFieldName, QMetaType::Type::Double ) );
261
262 mFields = outFields;
263 return outFields;
264 }
265}
266
267bool QgsPointsInPolygonAlgorithm::supportInPlaceEdit( const QgsMapLayer *layer ) const
268{
269 if ( const QgsVectorLayer *vl = qobject_cast<const QgsVectorLayer *>( layer ) )
270 {
271 return vl->geometryType() == Qgis::GeometryType::Polygon;
272 }
273 return false;
274}
275
276
ProcessingSourceType
Processing data source types.
Definition qgis.h:3645
@ VectorPoint
Vector point layers.
Definition qgis.h:3648
@ VectorPolygon
Vector polygon layers.
Definition qgis.h:3650
@ NotPresent
No spatial index exists for the source.
Definition qgis.h:586
@ Polygon
Polygons.
Definition qgis.h:382
static QIcon getThemeIcon(const QString &name, const QColor &fillColor=QColor(), const QColor &strokeColor=QColor())
Helper to get a theme icon.
static QString iconPath(const QString &iconFile)
Returns path to the desired icon file.
A vector of attributes.
Represents a coordinate reference system (CRS).
Wrapper for iterator of features from vector data provider or vector layer.
bool nextFeature(QgsFeature &f)
Fetch next feature and stores in f, returns true on success.
Wraps a request for features to a vector layer (or directly its vector data provider).
QgsFeatureRequest & setSubsetOfAttributes(const QgsAttributeList &attrs)
Set a subset of attributes that will be fetched.
QgsFeatureRequest & setDestinationCrs(const QgsCoordinateReferenceSystem &crs, const QgsCoordinateTransformContext &context)
Sets the destination crs for feature's geometries.
QgsFeatureRequest & setFilterRect(const QgsRectangle &rectangle)
Sets the rectangle from which features will be taken.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:60
QgsAttributes attributes
Definition qgsfeature.h:69
void setAttributes(const QgsAttributes &attrs)
Sets the feature's attributes.
QgsGeometry geometry
Definition qgsfeature.h:71
bool hasGeometry() const
Returns true if the feature has an associated geometry.
Q_INVOKABLE QVariant attribute(const QString &name) const
Lookup attribute value by attribute name.
bool isCanceled() const
Tells whether the operation has been canceled already.
Definition qgsfeedback.h:56
Encapsulate a field in an attribute table or data source.
Definition qgsfield.h:56
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:75
Q_INVOKABLE int lookupField(const QString &fieldName) const
Looks up field's index from the field name.
A geometry is the spatial representation of a feature.
const QgsAbstractGeometry * constGet() const
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
QgsRectangle boundingBox() const
Returns the bounding box of the geometry.
static QgsGeometryEngine * createGeometryEngine(const QgsAbstractGeometry *geometry, double precision=0.0, Qgis::GeosCreationFlags flags=Qgis::GeosCreationFlag::SkipEmptyInteriorRings)
Creates and returns a new geometry engine representing the specified geometry using precision on a gr...
Base class for all map layer types.
Definition qgsmaplayer.h:83
Contains information about the context in which a processing algorithm is executed.
QgsCoordinateTransformContext transformContext() const
Returns the coordinate transform context.
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
virtual void pushWarning(const QString &warning)
Pushes a warning informational message from the algorithm.
virtual void reportError(const QString &error, bool fatalError=false)
Reports that the algorithm encountered an error while executing.
An input feature source (such as vector layers) parameter for processing algorithms.
A vector layer or feature source field parameter for processing algorithms.
A string parameter for processing algorithms.
Represents a vector layer which manages a vector based dataset.
QList< QgsFeature > QgsFeatureList