QGIS API Documentation 3.99.0-Master (09f76ad7019)
Loading...
Searching...
No Matches
qgsalgorithmmultiintersection.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmmultiintersection.cpp
3 ------------------
4 begin : December 2021
5 copyright : (C) 2021 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 "qgsoverlayutils.h"
21#include "qgsvectorlayer.h"
22
23#include <QString>
24
25using namespace Qt::StringLiterals;
26
28
29
30QString QgsMultiIntersectionAlgorithm::name() const
31{
32 return u"multiintersection"_s;
33}
34
35QString QgsMultiIntersectionAlgorithm::displayName() const
36{
37 return QObject::tr( "Intersection (multiple)" );
38}
39
40QStringList QgsMultiIntersectionAlgorithm::tags() const
41{
42 return QObject::tr( "intersection,extract,overlap" ).split( ',' );
43}
44
45QString QgsMultiIntersectionAlgorithm::group() const
46{
47 return QObject::tr( "Vector overlay" );
48}
49
50QString QgsMultiIntersectionAlgorithm::groupId() const
51{
52 return u"vectoroverlay"_s;
53}
54
55QString QgsMultiIntersectionAlgorithm::shortHelpString() const
56{
57 return QObject::tr( "This algorithm extracts the overlapping portions of features in the Input and all Overlay layers. "
58 "Features in the output layer are assigned the attributes of the overlapping features "
59 "from both the Input and Overlay layers." );
60}
61
62QString QgsMultiIntersectionAlgorithm::shortDescription() const
63{
64 return QObject::tr( "Extracts portions of input features that overlap features from all other layers." );
65}
66
67Qgis::ProcessingAlgorithmDocumentationFlags QgsMultiIntersectionAlgorithm::documentationFlags() const
68{
70}
71
72QgsProcessingAlgorithm *QgsMultiIntersectionAlgorithm::createInstance() const
73{
74 return new QgsMultiIntersectionAlgorithm();
75}
76
77void QgsMultiIntersectionAlgorithm::initAlgorithm( const QVariantMap & )
78{
79 addParameter( new QgsProcessingParameterFeatureSource( u"INPUT"_s, QObject::tr( "Input layer" ) ) );
80 addParameter( new QgsProcessingParameterMultipleLayers( u"OVERLAYS"_s, QObject::tr( "Overlay layers" ), Qgis::ProcessingSourceType::VectorAnyGeometry ) );
81
82 auto prefix = std::make_unique<QgsProcessingParameterString>( u"OVERLAY_FIELDS_PREFIX"_s, QObject::tr( "Overlay fields prefix" ), QString(), false, true );
83 prefix->setFlags( prefix->flags() | Qgis::ProcessingParameterFlag::Advanced );
84 addParameter( prefix.release() );
85
86 addParameter( new QgsProcessingParameterFeatureSink( u"OUTPUT"_s, QObject::tr( "Intersection" ) ) );
87}
88
89QVariantMap QgsMultiIntersectionAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
90{
91 std::unique_ptr<QgsFeatureSource> sourceA( parameterAsSource( parameters, u"INPUT"_s, context ) );
92 if ( !sourceA )
93 throw QgsProcessingException( invalidSourceError( parameters, u"INPUT"_s ) );
94
95 const QList<QgsMapLayer *> layers = parameterAsLayerList( parameters, u"OVERLAYS"_s, context );
96
97 // loop through overlay layers and check whether they are vectors
98 long totalLayerCount = 0;
99 for ( QgsMapLayer *layer : layers )
100 {
101 if ( feedback->isCanceled() )
102 break;
103
104 if ( !layer )
105 throw QgsProcessingException( QObject::tr( "Error retrieving map layer." ) );
106
107 if ( layer->type() != Qgis::LayerType::Vector )
108 throw QgsProcessingException( QObject::tr( "All layers must be vector layers!" ) );
109
110 totalLayerCount++;
111 }
112
113 const QString overlayFieldsPrefix = parameterAsString( parameters, u"OVERLAY_FIELDS_PREFIX"_s, context );
114
115 const Qgis::WkbType geometryType = QgsWkbTypes::multiType( sourceA->wkbType() );
116 const QgsCoordinateReferenceSystem crs = sourceA->sourceCrs();
117 std::unique_ptr<QgsFeatureSink> sink;
118 long count = 0;
119 QVariantMap outputs;
120
121 QList<int> fieldIndicesA, fieldIndicesB;
122 QgsFields outputFields;
123
124 if ( totalLayerCount == 1 )
125 {
126 QgsVectorLayer *overlayLayer = qobject_cast<QgsVectorLayer *>( layers.at( 0 ) );
127
128 fieldIndicesA = QgsProcessingUtils::fieldNamesToIndices( QStringList(), sourceA->fields() );
129 fieldIndicesB = QgsProcessingUtils::fieldNamesToIndices( QStringList(), overlayLayer->fields() );
130
132 QgsProcessingUtils::indicesToFields( fieldIndicesA, sourceA->fields() ),
133 QgsProcessingUtils::indicesToFields( fieldIndicesB, overlayLayer->fields() ),
134 overlayFieldsPrefix
135 );
136
137 QString dest;
138 sink.reset( parameterAsSink( parameters, u"OUTPUT"_s, context, dest, outputFields, geometryType, crs, QgsFeatureSink::RegeneratePrimaryKey ) );
139 if ( !sink )
140 throw QgsProcessingException( invalidSinkError( parameters, u"OUTPUT"_s ) );
141
142 outputs.insert( u"OUTPUT"_s, dest );
143
144 const long total = sourceA->featureCount();
145 QgsOverlayUtils::intersection( *sourceA, *overlayLayer, *sink, context, feedback, count, total, fieldIndicesA, fieldIndicesB );
146
147 sink->finalize();
148 }
149 else
150 {
151 QgsProcessingMultiStepFeedback multiStepFeedback( totalLayerCount, feedback );
152 QgsVectorLayer *intersectionLayer = nullptr;
153
154 long i = 0;
155 for ( QgsMapLayer *layer : layers )
156 {
157 if ( feedback->isCanceled() )
158 break;
159
160 multiStepFeedback.setCurrentStep( i );
161
162 if ( !layer )
163 continue;
164
165 QgsVectorLayer *overlayLayer = qobject_cast<QgsVectorLayer *>( layer );
166 if ( !overlayLayer )
167 continue;
168
169 count = 0;
170 if ( i == 0 )
171 {
172 fieldIndicesA = QgsProcessingUtils::fieldNamesToIndices( QStringList(), sourceA->fields() );
173 fieldIndicesB = QgsProcessingUtils::fieldNamesToIndices( QStringList(), overlayLayer->fields() );
174
176 QgsProcessingUtils::indicesToFields( fieldIndicesA, sourceA->fields() ),
177 QgsProcessingUtils::indicesToFields( fieldIndicesB, overlayLayer->fields() ),
178 overlayFieldsPrefix
179 );
180
181 QString id = u"memory:"_s;
182 sink.reset( QgsProcessingUtils::createFeatureSink( id, context, outputFields, geometryType, crs ) );
183 QgsOverlayUtils::intersection( *sourceA, *overlayLayer, *sink, context, &multiStepFeedback, count, sourceA->featureCount(), fieldIndicesA, fieldIndicesB );
184
185 intersectionLayer = qobject_cast<QgsVectorLayer *>( QgsProcessingUtils::mapLayerFromString( id, context ) );
186 }
187 else if ( i == totalLayerCount - 1 )
188 {
189 fieldIndicesA = QgsProcessingUtils::fieldNamesToIndices( QStringList(), intersectionLayer->fields() );
190 fieldIndicesB = QgsProcessingUtils::fieldNamesToIndices( QStringList(), overlayLayer->fields() );
191
193 QgsProcessingUtils::indicesToFields( fieldIndicesA, intersectionLayer->fields() ),
194 QgsProcessingUtils::indicesToFields( fieldIndicesB, overlayLayer->fields() ),
195 overlayFieldsPrefix
196 );
197
198 QString dest;
199 std::unique_ptr<QgsFeatureSink> sink( parameterAsSink( parameters, u"OUTPUT"_s, context, dest, outputFields, geometryType, crs ) );
200 if ( !sink )
201 throw QgsProcessingException( invalidSinkError( parameters, u"OUTPUT"_s ) );
202
203 outputs.insert( u"OUTPUT"_s, dest );
204
205 QgsOverlayUtils::intersection( *intersectionLayer, *overlayLayer, *sink, context, &multiStepFeedback, count, intersectionLayer->featureCount(), fieldIndicesA, fieldIndicesB );
206 }
207 else
208 {
209 fieldIndicesA = QgsProcessingUtils::fieldNamesToIndices( QStringList(), intersectionLayer->fields() );
210 fieldIndicesB = QgsProcessingUtils::fieldNamesToIndices( QStringList(), overlayLayer->fields() );
211
213 QgsProcessingUtils::indicesToFields( fieldIndicesA, intersectionLayer->fields() ),
214 QgsProcessingUtils::indicesToFields( fieldIndicesB, overlayLayer->fields() ),
215 overlayFieldsPrefix
216 );
217
218 QString id = u"memory:"_s;
219 sink.reset( QgsProcessingUtils::createFeatureSink( id, context, outputFields, geometryType, crs ) );
220 QgsOverlayUtils::intersection( *intersectionLayer, *overlayLayer, *sink, context, &multiStepFeedback, count, intersectionLayer->featureCount(), fieldIndicesA, fieldIndicesB );
221
222 intersectionLayer = qobject_cast<QgsVectorLayer *>( QgsProcessingUtils::mapLayerFromString( id, context ) );
223 }
224
225 i++;
226 }
227 }
228
229 return outputs;
230}
231
@ VectorAnyGeometry
Any vector layer with geometry.
Definition qgis.h:3604
@ RegeneratesPrimaryKey
Algorithm always drops any existing primary keys or FID values and regenerates them in outputs.
Definition qgis.h:3690
@ Vector
Vector layer.
Definition qgis.h:194
QFlags< ProcessingAlgorithmDocumentationFlag > ProcessingAlgorithmDocumentationFlags
Flags describing algorithm behavior for documentation purposes.
Definition qgis.h:3701
WkbType
The WKB type describes the number of dimensions a geometry has.
Definition qgis.h:280
@ Advanced
Parameter is an advanced parameter which should be hidden from users by default.
Definition qgis.h:3834
Represents a coordinate reference system (CRS).
@ RegeneratePrimaryKey
This flag indicates, that a primary key field cannot be guaranteed to be unique and the sink should i...
bool isCanceled() const
Tells whether the operation has been canceled already.
Definition qgsfeedback.h:55
Container of fields for a vector layer.
Definition qgsfields.h:46
Base class for all map layer types.
Definition qgsmaplayer.h:83
Abstract base class for processing algorithms.
Contains information about the context in which a processing algorithm is executed.
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
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 parameter for processing algorithms which accepts multiple map layers.
static QgsFields indicesToFields(const QList< int > &indices, const QgsFields &fields)
Returns a subset of fields based on the indices of desired fields.
static QList< int > fieldNamesToIndices(const QStringList &fieldNames, const QgsFields &fields)
Returns a list of field indices parsed from the given list of field names.
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).
static QgsFeatureSink * createFeatureSink(QString &destination, QgsProcessingContext &context, const QgsFields &fields, Qgis::WkbType geometryType, const QgsCoordinateReferenceSystem &crs, const QVariantMap &createOptions=QVariantMap(), const QStringList &datasourceOptions=QStringList(), const QStringList &layerOptions=QStringList(), QgsFeatureSink::SinkFlags sinkFlags=QgsFeatureSink::SinkFlags(), QgsRemappingSinkDefinition *remappingDefinition=nullptr)
Creates a feature sink ready for adding features.
static QgsMapLayer * mapLayerFromString(const QString &string, QgsProcessingContext &context, bool allowLoadingNewLayers=true, QgsProcessingUtils::LayerHint typeHint=QgsProcessingUtils::LayerHint::UnknownType, QgsProcessing::LayerOptionsFlags flags=QgsProcessing::LayerOptionsFlags())
Interprets a string as a map layer within the supplied context.
Represents a vector layer which manages a vector based dataset.
long long featureCount(const QString &legendKey) const
Number of features rendered with specified legend key.
static Qgis::WkbType multiType(Qgis::WkbType type)
Returns the multi type for a WKB type.