QGIS API Documentation 3.39.0-Master (bca3cdb6021)
|
Utility functions for use with processing classes. More...
#include <qgsprocessingutils.h>
Public Types | |
enum class | LayerHint : int { UnknownType , Vector , Raster , Mesh , PointCloud , Annotation , VectorTile , TiledScene } |
Layer type hints. More... | |
Static Public Member Functions | |
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 QgsRectangle | combineLayerExtents (const QList< QgsMapLayer * > &layers, const QgsCoordinateReferenceSystem &crs, QgsProcessingContext &context) |
Combines the extent of several map layers. | |
static Q_DECL_DEPRECATED QgsRectangle | combineLayerExtents (const QList< QgsMapLayer * > &layers, const QgsCoordinateReferenceSystem &crs=QgsCoordinateReferenceSystem()) |
Combines the extent of several map layers. | |
static QList< QgsAnnotationLayer * > | compatibleAnnotationLayers (QgsProject *project, bool sort=true) |
Returns a list of annotation layers from a project which are compatible with the processing framework. | |
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. | |
static QList< QgsMeshLayer * > | compatibleMeshLayers (QgsProject *project, bool sort=true) |
Returns a list of mesh layers from a project which are compatible with the processing framework. | |
static QList< QgsPluginLayer * > | compatiblePluginLayers (QgsProject *project, bool sort=true) |
Returns a list of plugin layers from a project which are compatible with the processing framework. | |
static QList< QgsPointCloudLayer * > | compatiblePointCloudLayers (QgsProject *project, bool sort=true) |
Returns a list of point cloud layers from a project which are compatible with the processing framework. | |
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. | |
static QList< QgsTiledSceneLayer * > | compatibleTiledSceneLayers (QgsProject *project, bool sort=true) |
Returns a list of tiled scene layers from a project which are compatible with the processing framework. | |
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. | |
static QList< QgsVectorTileLayer * > | compatibleVectorTileLayers (QgsProject *project, bool sort=true) |
Returns a list of vector tile layers from a project which are compatible with the processing framework. | |
static QString | convertToCompatibleFormat (const QgsVectorLayer *layer, bool selectedFeaturesOnly, const QString &baseName, const QStringList &compatibleFormats, const QString &preferredFormat, QgsProcessingContext &context, QgsProcessingFeedback *feedback, long long featureLimit=-1, const QString &filterExpression=QString()) |
Converts a source vector layer to a file path of a vector layer of compatible format. | |
static QString | convertToCompatibleFormatAndLayerName (const QgsVectorLayer *layer, bool selectedFeaturesOnly, const QString &baseName, const QStringList &compatibleFormats, const QString &preferredFormat, QgsProcessingContext &context, QgsProcessingFeedback *feedback, QString &layerName, long long featureLimit=-1, const QString &filterExpression=QString()) |
Converts a source vector layer to a file path and layer name of a vector layer of compatible format. | |
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 void | createFeatureSinkPython (QgsFeatureSink **sink, QString &destination, QgsProcessingContext &context, const QgsFields &fields, Qgis::WkbType geometryType, const QgsCoordinateReferenceSystem &crs, const QVariantMap &createOptions=QVariantMap()) |
Creates a feature sink ready for adding features. | |
static bool | decodeProviderKeyAndUri (const QString &string, QString &providerKey, QString &uri) |
Decodes a provider key and layer uri from an encoded string, for use with encodeProviderKeyAndUri() | |
static QString | defaultPointCloudExtension () |
Returns the default point cloud extension to use, in the absence of all other constraints (e.g. | |
static QString | defaultRasterExtension () |
Returns the default raster extension to use, in the absence of all other constraints (e.g. | |
static QString | defaultVectorExtension () |
Returns the default vector extension to use, in the absence of all other constraints (e.g. | |
static QString | defaultVectorTileExtension () |
Returns the default vector tile extension to use, in the absence of all other constraints (e.g. | |
static QString | encodeProviderKeyAndUri (const QString &providerKey, const QString &uri) |
Encodes a provider key and layer uri to a single string, for use with decodeProviderKeyAndUri() | |
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 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. | |
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. | |
static QString | generateTempFilename (const QString &basename, const QgsProcessingContext *context=nullptr) |
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. | |
static QgsFields | indicesToFields (const QList< int > &indices, const QgsFields &fields) |
Returns a subset of fields based on the indices of desired fields. | |
static QString | layerToStringIdentifier (const QgsMapLayer *layer) |
Returns a string representation of the source for a layer. | |
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. | |
static QString | normalizeLayerSource (const QString &source) |
Normalizes a layer source string for safe comparison across different operating system environments. | |
static QVariantMap | preprocessQgisProcessParameters (const QVariantMap ¶meters, bool &ok, QString &error) |
Pre-processes a set of parameter values for the qgis_process command. | |
static QVariantMap | removePointerValuesFromMap (const QVariantMap &map) |
Removes any raw pointer values from an input map, replacing them with appropriate string values where possible. | |
static QString | resolveDefaultEncoding (const QString &defaultEncoding="System") |
Returns the default encoding. | |
static QString | stringToPythonLiteral (const QString &string) |
Converts a string to a Python string literal. | |
static QString | tempFolder (const QgsProcessingContext *context=nullptr) |
Returns a session specific processing temporary folder for use in processing algorithms. | |
static QgsCoordinateReferenceSystem | variantToCrs (const QVariant &value, QgsProcessingContext &context, const QVariant &fallbackValue=QVariant()) |
Converts a variant value to a coordinate reference system. | |
static QString | variantToPythonLiteral (const QVariant &value) |
Converts a variant to a Python literal. | |
static QgsProcessingFeatureSource * | variantToSource (const QVariant &value, QgsProcessingContext &context, const QVariant &fallbackValue=QVariant()) |
Converts a variant value to a new feature source. | |
Friends | |
class | QgsProcessingProvider |
class | TestQgsProcessing |
Utility functions for use with processing classes.
Definition at line 52 of file qgsprocessingutils.h.
|
strong |
Layer type hints.
Definition at line 255 of file qgsprocessingutils.h.
|
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.
Definition at line 1490 of file qgsprocessingutils.cpp.
|
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 using the specified context.
Definition at line 1164 of file qgsprocessingutils.cpp.
|
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 1198 of file qgsprocessingutils.cpp.
|
static |
Returns a list of annotation 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.
Definition at line 87 of file qgsprocessingutils.cpp.
|
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.
Definition at line 138 of file qgsprocessingutils.cpp.
|
static |
Returns a list of mesh 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.
Definition at line 72 of file qgsprocessingutils.cpp.
|
static |
Returns a list of plugin 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.
Definition at line 77 of file qgsprocessingutils.cpp.
|
static |
Returns a list of point cloud 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.
Definition at line 82 of file qgsprocessingutils.cpp.
|
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.
Definition at line 44 of file qgsprocessingutils.cpp.
|
static |
Returns a list of tiled scene 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.
Definition at line 110 of file qgsprocessingutils.cpp.
|
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.
Definition at line 49 of file qgsprocessingutils.cpp.
|
static |
Returns a list of vector tile 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.
Definition at line 105 of file qgsprocessingutils.cpp.
|
static |
Converts a source vector layer to a file path of 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.
The featureLimit argument can be used to specify a limit on the number of features read from the layer.
Since QGIS 3.32, the optional filterExpression argument can be used to specify a expression to use to filter the features read from the layer.
When an algorithm is capable of handling multi-layer input files (such as Geopackage), it is preferable to use convertToCompatibleFormatAndLayerName() which may avoid conversion in more situations.
Definition at line 1479 of file qgsprocessingutils.cpp.
|
static |
Converts a source vector layer to a file path and layer name of 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 featureLimit argument can be used to specify a limit on the number of features read from the layer.
The preferredFormat argument is used to specify to desired file extension to use when a temporary layer export is required. This defaults to shapefiles.
This method should be preferred over convertToCompatibleFormat() when an algorithm is able to correctly handle files with multiple layers. Unlike convertToCompatibleFormat(), it will not force a conversion in this case and will return the target layer name in the layerName argument.
layer | source layer to convert (if required) |
selectedFeaturesOnly | true if only selected features from the layer should be used |
baseName | base file name for converted layer, if required |
compatibleFormats | a list of lowercase file extensions compatible with the algorithm |
preferredFormat | preferred format extension to use if conversion if required |
context | processing context |
feedback | feedback object |
layerName | will be set to the target layer name for multi-layer sources (e.g. Geopackage) |
featureLimit | can be used to place a limit on the maximum number of features read from the layer |
filterExpression | optional expression for filtering features read from the layer (since QGIS 3.32) |
Definition at line 1484 of file qgsprocessingutils.cpp.
|
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.
The caller takes responsibility for deleting the returned sink.
Definition at line 959 of file qgsprocessingutils.cpp.
|
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.
Definition at line 1158 of file qgsprocessingutils.cpp.
|
static |
Decodes a provider key and layer uri from an encoded string, for use with encodeProviderKeyAndUri()
string | encoded string, as returned by encodeProviderKeyAndUri() |
providerKey | ID key for corresponding data provider |
uri | decoded layer uri |
true
if string was successfully decodedDefinition at line 193 of file qgsprocessingutils.cpp.
|
static |
Returns the default point cloud extension to use, in the absence of all other constraints (e.g.
provider based support for extensions).
This method returns a fallback value of "las".
Definition at line 1589 of file qgsprocessingutils.cpp.
|
static |
Returns the default raster extension to use, in the absence of all other constraints (e.g.
provider based support for extensions).
This method returns the user-set default extension from the processing settings, or a fallback value of "tif".
Definition at line 1573 of file qgsprocessingutils.cpp.
|
static |
Returns the default vector extension to use, in the absence of all other constraints (e.g.
provider based support for extensions).
This method returns the user-set default extension from the processing settings, or a fallback value of "gpkg".
Definition at line 1557 of file qgsprocessingutils.cpp.
|
static |
Returns the default vector tile extension to use, in the absence of all other constraints (e.g.
provider based support for extensions).
This method returns a fallback value of "mbtiles".
Definition at line 1594 of file qgsprocessingutils.cpp.
|
static |
Encodes a provider key and layer uri to a single string, for use with decodeProviderKeyAndUri()
Definition at line 188 of file qgsprocessingutils.cpp.
|
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.
Definition at line 1526 of file qgsprocessingutils.cpp.
|
static |
Returns a HTML formatted version of the help text encoded in a variant map for a specified algorithm.
Definition at line 1296 of file qgsprocessingutils.cpp.
|
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 1204 of file qgsprocessingutils.cpp.
|
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.
Definition at line 1284 of file qgsprocessingutils.cpp.
|
static |
Returns a subset of fields based on the indices of desired fields.
Definition at line 1549 of file qgsprocessingutils.cpp.
|
static |
Returns a string representation of the source for a layer.
The returned value is suitable for storage for subsequent executions of an algorithm using the same layer source.
Definition at line 745 of file qgsprocessingutils.cpp.
|
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.
The typeHint can be used to dictate the type of map layer expected.
Definition at line 512 of file qgsprocessingutils.cpp.
|
static |
Normalizes a layer source string for safe comparison across different operating system environments.
Definition at line 738 of file qgsprocessingutils.cpp.
|
static |
Pre-processes a set of parameter values for the qgis_process command.
In particular, this function upgrades encoded data defined values to QgsProperty objects.
Definition at line 1655 of file qgsprocessingutils.cpp.
|
static |
Removes any raw pointer values from an input map, replacing them with appropriate string values where possible.
Definition at line 1599 of file qgsprocessingutils.cpp.
|
static |
Returns the default encoding.
The default encoding could be the one from "/Processing/encoding" or when it's not an allowed encoding name like "System", the default encoding system (mostly UTF-8 on Unix-like, windows-1252 on Windows).
Definition at line 1712 of file qgsprocessingutils.cpp.
|
static |
Converts a string to a Python string literal.
E.g. by replacing ' with \'.
Definition at line 868 of file qgsprocessingutils.cpp.
|
static |
Returns a session specific processing temporary folder for use in processing algorithms.
Definition at line 1243 of file qgsprocessingutils.cpp.
|
static |
Converts a variant value to a coordinate reference system.
The optional fallbackValue can be used to specify a "default" value which is used if value cannot be successfully converted to a CRS.
Definition at line 627 of file qgsprocessingutils.cpp.
|
static |
Converts a variant to a Python literal.
Definition at line 766 of file qgsprocessingutils.cpp.
|
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 548 of file qgsprocessingutils.cpp.
|
friend |
Definition at line 675 of file qgsprocessingutils.h.
|
friend |
Definition at line 674 of file qgsprocessingutils.h.