QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsalgorithmconvexhull.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmconvexhull.cpp
3 ---------------------
4 begin : April 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 QgsConvexHullAlgorithm::name() const
23{
24 return QStringLiteral( "convexhull" );
25}
26
27QString QgsConvexHullAlgorithm::displayName() const
28{
29 return QObject::tr( "Convex hull" );
30}
31
32QStringList QgsConvexHullAlgorithm::tags() const
33{
34 return QObject::tr( "convex,hull,bounds,bounding" ).split( ',' );
35}
36
37QString QgsConvexHullAlgorithm::group() const
38{
39 return QObject::tr( "Vector geometry" );
40}
41
42QString QgsConvexHullAlgorithm::groupId() const
43{
44 return QStringLiteral( "vectorgeometry" );
45}
46
47QString QgsConvexHullAlgorithm::outputName() const
48{
49 return QObject::tr( "Convex hulls" );
50}
51
52QString QgsConvexHullAlgorithm::shortHelpString() const
53{
54 return QObject::tr( "This algorithm calculates the convex hull for each feature in an input layer." ) +
55 QStringLiteral( "\n\n" ) +
56 QObject::tr( "See the 'Minimum bounding geometry' algorithm for a convex hull calculation which covers the whole layer or grouped subsets of features." );
57}
58
59QgsConvexHullAlgorithm *QgsConvexHullAlgorithm::createInstance() const
60{
61 return new QgsConvexHullAlgorithm();
62}
63
64QgsFields QgsConvexHullAlgorithm::outputFields( const QgsFields &inputFields ) const
65{
66 QgsFields fields = inputFields;
67 fields.append( QgsField( QStringLiteral( "area" ), QVariant::Double, QString(), 20, 6 ) );
68 fields.append( QgsField( QStringLiteral( "perimeter" ), QVariant::Double, QString(), 20, 6 ) );
69 return fields;
70}
71
72QgsFeatureList QgsConvexHullAlgorithm::processFeature( const QgsFeature &feature, QgsProcessingContext &, QgsProcessingFeedback *feedback )
73{
74 QgsFeature f = feature;
75 if ( f.hasGeometry() )
76 {
77 QgsGeometry outputGeometry;
79 {
80 feedback->reportError( QObject::tr( "Cannot calculate convex hull for a single Point feature (try 'Minimum bounding geometry' algorithm instead)." ) );
81 f.clearGeometry();
82 }
83 else
84 {
85 outputGeometry = f.geometry().convexHull();
86 if ( outputGeometry.isNull() )
87 feedback->reportError( outputGeometry.lastError() );
88 f.setGeometry( outputGeometry );
89 }
90 if ( !outputGeometry.isNull() )
91 {
92 QgsAttributes attrs = f.attributes();
93 attrs << outputGeometry.constGet()->area()
94 << outputGeometry.constGet()->perimeter();
95 f.setAttributes( attrs );
96 }
97 else
98 {
99 QgsAttributes attrs = f.attributes();
100 attrs << QVariant()
101 << QVariant();
102 f.setAttributes( attrs );
103 }
104 }
105 return QgsFeatureList() << f;
106}
107
109
virtual double perimeter() const
Returns the planar, 2-dimensional perimeter of the geometry.
virtual double area() const
Returns the planar, 2-dimensional area of the geometry.
A vector of attributes.
Definition: qgsattributes.h:59
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition: qgsfeature.h:56
QgsAttributes attributes
Definition: qgsfeature.h:65
void setAttributes(const QgsAttributes &attrs)
Sets the feature's attributes.
Definition: qgsfeature.cpp:160
QgsGeometry geometry
Definition: qgsfeature.h:67
void clearGeometry()
Removes any geometry associated with the feature.
Definition: qgsfeature.cpp:181
bool hasGeometry() const
Returns true if the feature has an associated geometry.
Definition: qgsfeature.cpp:230
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
Definition: qgsfeature.cpp:167
Encapsulate a field in an attribute table or data source.
Definition: qgsfield.h:53
Container of fields for a vector layer.
Definition: qgsfields.h:45
bool append(const QgsField &field, FieldOrigin origin=OriginProvider, int originIndex=-1)
Appends a field. The field must have unique name, otherwise it is rejected (returns false)
Definition: qgsfields.cpp:59
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:162
QString lastError() const
Returns an error string referring to the last error encountered either when this geometry was created...
Q_GADGET bool isNull
Definition: qgsgeometry.h:164
const QgsAbstractGeometry * constGet() const
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
QgsGeometry convexHull() const
Returns the smallest convex polygon that contains all the points in the geometry.
Qgis::WkbType wkbType() const
Returns type of the geometry as a WKB type (point / linestring / polygon etc.)
Contains information about the context in which a processing algorithm is executed.
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 Qgis::WkbType flatType(Qgis::WkbType type)
Returns the flat type for a WKB type.
Definition: qgswkbtypes.h:628
QList< QgsFeature > QgsFeatureList
Definition: qgsfeature.h:917