QGIS API Documentation  3.2.0-Bonn (bc43194)
Static Public Member Functions | Friends | List of all members
QgsProcessingUtils Class Reference

Utility functions for use with processing classes. More...

#include <qgsprocessingutils.h>

Static Public Member Functions

static QgsFields combineFields (const QgsFields &fieldsA, const QgsFields &fieldsB)
 Combines two field lists, avoiding duplicate field names (in a case-insensitive manner). More...
 
static QgsRectangle combineLayerExtents (const QList< QgsMapLayer *> &layers, const QgsCoordinateReferenceSystem &crs=QgsCoordinateReferenceSystem())
 Combines the extent of several map layers. More...
 
static QList< QgsMapLayer *> compatibleLayers (QgsProject *project, bool sort=true)
 Returns a list of map layers from a project which are compatible with the processing framework. More...
 
static QList< QgsRasterLayer *> compatibleRasterLayers (QgsProject *project, bool sort=true)
 Returns a list of raster layers from a project which are compatible with the processing framework. More...
 
static QList< QgsVectorLayer *> compatibleVectorLayers (QgsProject *project, const QList< int > &sourceTypes=QList< int >(), bool sort=true)
 Returns a list of vector layers from a project which are compatible with the processing framework. More...
 
static QString convertToCompatibleFormat (const QgsVectorLayer *layer, bool selectedFeaturesOnly, const QString &baseName, const QStringList &compatibleFormats, const QString &preferredFormat, QgsProcessingContext &context, QgsProcessingFeedback *feedback)
 Converts a source vector layer to a file path to a vector layer of compatible format. More...
 
static QgsFeatureSinkcreateFeatureSink (QString &destination, QgsProcessingContext &context, const QgsFields &fields, QgsWkbTypes::Type geometryType, const QgsCoordinateReferenceSystem &crs, const QVariantMap &createOptions=QVariantMap())
 Creates a feature sink ready for adding features. More...
 
static void createFeatureSinkPython (QgsFeatureSink **sink, QString &destination, QgsProcessingContext &context, const QgsFields &fields, QgsWkbTypes::Type geometryType, const QgsCoordinateReferenceSystem &crs, const QVariantMap &createOptions=QVariantMap()) SIP_THROW(QgsProcessingException)
 Creates a feature sink ready for adding features. More...
 
static QList< int > fieldNamesToIndices (const QStringList &fieldNames, const QgsFields &fields)
 Returns a list of field indices parsed from the given list of field names. More...
 
static QString formatHelpMapAsHtml (const QVariantMap &map, const QgsProcessingAlgorithm *algorithm)
 Returns a HTML formatted version of the help text encoded in a variant map for a specified algorithm. More...
 
static QVariant generateIteratingDestination (const QVariant &input, const QVariant &id, QgsProcessingContext &context)
 Converts an input parameter value for use in source iterating mode, where one individual sink is created per input feature. More...
 
static QString generateTempFilename (const QString &basename)
 Returns a temporary filename for a given file, putting it into a temporary folder (creating that folder in the process), but not changing the basename. More...
 
static QgsFields indicesToFields (const QList< int > &indices, const QgsFields &fields)
 Returns a subset of fields based on the indices of desired fields. More...
 
static QgsMapLayermapLayerFromString (const QString &string, QgsProcessingContext &context, bool allowLoadingNewLayers=true)
 Interprets a string as a map layer within the supplied context. More...
 
static QString normalizeLayerSource (const QString &source)
 Normalizes a layer source string for safe comparison across different operating system environments. More...
 
static QString stringToPythonLiteral (const QString &string)
 Converts a string to a Python string literal. More...
 
static QString tempFolder ()
 Returns a session specific processing temporary folder for use in processing algorithms. More...
 
static QgsProcessingFeatureSourcevariantToSource (const QVariant &value, QgsProcessingContext &context, const QVariant &fallbackValue=QVariant())
 Converts a variant value to a new feature source. More...
 

Friends

class TestQgsProcessing
 

Detailed Description

Utility functions for use with processing classes.

Since
QGIS 3.0

Definition at line 44 of file qgsprocessingutils.h.

Member Function Documentation

◆ combineFields()

QgsFields QgsProcessingUtils::combineFields ( const QgsFields fieldsA,
const QgsFields fieldsB 
)
static

Combines two field lists, avoiding duplicate field names (in a case-insensitive manner).

Duplicate field names will be altered to "name_2", "name_3", etc, finding the first non-duplicate name.

Note
Some output file formats (e.g. shapefiles) have restrictions on the maximum length of field names, so be aware that the results of calling this method may be truncated when saving to these formats.

Definition at line 622 of file qgsprocessingutils.cpp.

◆ combineLayerExtents()

QgsRectangle QgsProcessingUtils::combineLayerExtents ( const QList< QgsMapLayer *> &  layers,
const QgsCoordinateReferenceSystem crs = QgsCoordinateReferenceSystem() 
)
static

Combines the extent of several map layers.

If specified, the target crs will be used to transform the layer's extent to the desired output reference system.

Definition at line 458 of file qgsprocessingutils.cpp.

◆ compatibleLayers()

QList< QgsMapLayer * > QgsProcessingUtils::compatibleLayers ( QgsProject project,
bool  sort = true 
)
static

Returns a list of map layers from a project which are compatible with the processing framework.

If the sort argument is true then the layers will be sorted by their QgsMapLayer::name() value.

See also
compatibleRasterLayers()
compatibleVectorLayers()

Definition at line 76 of file qgsprocessingutils.cpp.

◆ compatibleRasterLayers()

QList< QgsRasterLayer * > QgsProcessingUtils::compatibleRasterLayers ( QgsProject project,
bool  sort = true 
)
static

Returns a list of raster layers from a project which are compatible with the processing framework.

If the sort argument is true then the layers will be sorted by their QgsMapLayer::name() value.

See also
compatibleVectorLayers()
compatibleLayers()

Definition at line 32 of file qgsprocessingutils.cpp.

◆ compatibleVectorLayers()

QList< QgsVectorLayer * > QgsProcessingUtils::compatibleVectorLayers ( QgsProject project,
const QList< int > &  sourceTypes = QList< int >(),
bool  sort = true 
)
static

Returns a list of vector layers from a project which are compatible with the processing framework.

The sourceTypes list should be filled with a list of QgsProcessing::SourceType values. If the sourceTypes list is non-empty then the layers will be sorted so that only layers with the specified source type included in the list will be returned. Leaving the sourceTypes list empty will cause all vector layers, regardless of their geometry type, to be returned.

If the sort argument is true then the layers will be sorted by their QgsMapLayer::name() value.

See also
compatibleRasterLayers()
compatibleLayers()

Definition at line 54 of file qgsprocessingutils.cpp.

◆ convertToCompatibleFormat()

QString QgsProcessingUtils::convertToCompatibleFormat ( const QgsVectorLayer layer,
bool  selectedFeaturesOnly,
const QString &  baseName,
const QStringList &  compatibleFormats,
const QString &  preferredFormat,
QgsProcessingContext context,
QgsProcessingFeedback feedback 
)
static

Converts a source vector layer to a file path to a vector layer of compatible format.

If the specified layer is not of the format listed in the compatibleFormats argument, then the layer will first be exported to a compatible format in a temporary location using baseName. The function will then return the path to that temporary file.

compatibleFormats should consist entirely of lowercase file extensions, e.g. 'shp'.

The preferredFormat argument is used to specify to desired file extension to use when a temporary layer export is required. This defaults to shapefiles.

Definition at line 586 of file qgsprocessingutils.cpp.

◆ createFeatureSink()

QgsFeatureSink * QgsProcessingUtils::createFeatureSink ( QString &  destination,
QgsProcessingContext context,
const QgsFields fields,
QgsWkbTypes::Type  geometryType,
const QgsCoordinateReferenceSystem crs,
const QVariantMap &  createOptions = QVariantMap() 
)
static

Creates a feature sink ready for adding features.

The destination specifies a destination URI for the resultant layer. It may be updated in place to reflect the actual destination for the layer.

Sink parameters such as desired encoding, fields, geometryType and crs must be specified.

The createOptions map can be used to specify additional sink creation options, which are passed to the underlying provider when creating new layers. Known options also include 'fileEncoding', which is used to specify a file encoding to use for created files. If 'fileEncoding' is not specified, the default encoding from the context will be used.

If a layer is created for the feature sink, the layer will automatically be added to the context's temporary layer store.

The caller takes responsibility for deleting the returned sink.

Definition at line 371 of file qgsprocessingutils.cpp.

◆ createFeatureSinkPython()

void QgsProcessingUtils::createFeatureSinkPython ( QgsFeatureSink **  sink,
QString &  destination,
QgsProcessingContext context,
const QgsFields fields,
QgsWkbTypes::Type  geometryType,
const QgsCoordinateReferenceSystem crs,
const QVariantMap &  createOptions = QVariantMap() 
)
static

Creates a feature sink ready for adding features.

The destination specifies a destination URI for the resultant layer. It may be updated in place to reflect the actual destination for the layer.

Sink parameters such as desired fields, geometryType and crs must be specified.

The createOptions map can be used to specify additional sink creation options, which are passed to the underlying provider when creating new layers. Known options also include 'fileEncoding', which is used to specify a file encoding to use for created files. If 'fileEncoding' is not specified, the default encoding from the context will be used.

If a layer is created for the feature sink, the layer will automatically be added to the context's temporary layer store.

Note
this version of the createFeatureSink() function has an API designed around use from the SIP bindings. c++ code should call the other createFeatureSink() version.
available in Python bindings as createFeatureSink()

Definition at line 452 of file qgsprocessingutils.cpp.

◆ fieldNamesToIndices()

QList< int > QgsProcessingUtils::fieldNamesToIndices ( const QStringList &  fieldNames,
const QgsFields fields 
)
static

Returns a list of field indices parsed from the given list of field names.

Unknown field names are ignored. If the list of field names is empty, it is assumed that all fields are required.

Since
QGIS 3.2

Definition at line 658 of file qgsprocessingutils.cpp.

◆ formatHelpMapAsHtml()

QString QgsProcessingUtils::formatHelpMapAsHtml ( const QVariantMap &  map,
const QgsProcessingAlgorithm algorithm 
)
static

Returns a HTML formatted version of the help text encoded in a variant map for a specified algorithm.

Definition at line 554 of file qgsprocessingutils.cpp.

◆ generateIteratingDestination()

QVariant QgsProcessingUtils::generateIteratingDestination ( const QVariant &  input,
const QVariant &  id,
QgsProcessingContext context 
)
static

Converts an input parameter value for use in source iterating mode, where one individual sink is created per input feature.

The id parameter represents the unique ID for this output, which is embedded into the resulting parameter value.

Definition at line 492 of file qgsprocessingutils.cpp.

◆ generateTempFilename()

QString QgsProcessingUtils::generateTempFilename ( const QString &  basename)
static

Returns a temporary filename for a given file, putting it into a temporary folder (creating that folder in the process), but not changing the basename.

See also
tempFolder()

Definition at line 542 of file qgsprocessingutils.cpp.

◆ indicesToFields()

QgsFields QgsProcessingUtils::indicesToFields ( const QList< int > &  indices,
const QgsFields fields 
)
static

Returns a subset of fields based on the indices of desired fields.

Since
QGIS 3.2

Definition at line 681 of file qgsprocessingutils.cpp.

◆ mapLayerFromString()

QgsMapLayer * QgsProcessingUtils::mapLayerFromString ( const QString &  string,
QgsProcessingContext context,
bool  allowLoadingNewLayers = true 
)
static

Interprets a string as a map layer within the supplied context.

The method will attempt to load a layer matching the passed string. E.g. if the string matches a layer ID or name within the context's project or temporary layer store then this layer will be returned. If the string is a file path and allowLoadingNewLayers is true, then the layer at this file path will be loaded and added to the context's temporary layer store. Ownership of the layer remains with the context or the context's current project.

Definition at line 198 of file qgsprocessingutils.cpp.

◆ normalizeLayerSource()

QString QgsProcessingUtils::normalizeLayerSource ( const QString &  source)
static

Normalizes a layer source string for safe comparison across different operating system environments.

Definition at line 303 of file qgsprocessingutils.cpp.

◆ stringToPythonLiteral()

QString QgsProcessingUtils::stringToPythonLiteral ( const QString &  string)
static

Converts a string to a Python string literal.

E.g. by replacing ' with \'.

Definition at line 310 of file qgsprocessingutils.cpp.

◆ tempFolder()

QString QgsProcessingUtils::tempFolder ( )
static

Returns a session specific processing temporary folder for use in processing algorithms.

See also
generateTempFilename()

Definition at line 526 of file qgsprocessingutils.cpp.

◆ variantToSource()

QgsProcessingFeatureSource * QgsProcessingUtils::variantToSource ( const QVariant &  value,
QgsProcessingContext context,
const QVariant &  fallbackValue = QVariant() 
)
static

Converts a variant value to a new feature source.

Sources will either be taken from context's active project, or loaded from external sources and stored temporarily in the context.

The optional fallbackValue can be used to specify a "default" value which is used if value cannot be successfully converted to a source.

This function creates a new object and the caller takes responsibility for deleting the returned object.

Definition at line 231 of file qgsprocessingutils.cpp.

Friends And Related Function Documentation

◆ TestQgsProcessing

friend class TestQgsProcessing
friend

Definition at line 280 of file qgsprocessingutils.h.


The documentation for this class was generated from the following files: