QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
Contains information about the context in which a processing algorithm is executed. More...
#include <qgsprocessingcontext.h>
Classes | |
class | LayerDetails |
Details for layers to load into projects. More... | |
Public Types | |
enum | Flag { Unused = 1 << 0 } |
Flags that affect how processing algorithms are run. More... | |
typedef QFlags< Flag > | Flags |
enum class | ProcessArgumentFlag : int { IncludeProjectPath = 1 << 0 } |
Flags controlling the results given by asQgisProcessArguments(). More... | |
typedef QFlags< ProcessArgumentFlag > | ProcessArgumentFlags |
Public Member Functions | |
QgsProcessingContext () | |
QgsProcessingContext (const QgsProcessingContext &other)=delete | |
~QgsProcessingContext () | |
void | addLayerToLoadOnCompletion (const QString &layer, const QgsProcessingContext::LayerDetails &details) |
Adds a layer to load (by ID or datasource) into the canvas upon completion of the algorithm or model. | |
Qgis::AreaUnit | areaUnit () const |
Returns the area unit to use for area calculations. | |
QStringList | asQgisProcessArguments (QgsProcessingContext::ProcessArgumentFlags flags=QgsProcessingContext::ProcessArgumentFlags()) const |
Returns list of the equivalent qgis_process arguments representing the settings from the context. | |
void | copyThreadSafeSettings (const QgsProcessingContext &other) |
Copies all settings which are safe for use across different threads from other to this context. | |
QgsDateTimeRange | currentTimeRange () const |
Returns the current time range to use for temporal operations. | |
QString | defaultEncoding () const |
Returns the default encoding to use for newly created files. | |
std::function< void(const QgsFeature &) > | defaultInvalidGeometryCallbackForCheck (Qgis::InvalidGeometryCheck check, QgsFeatureSource *source=nullptr) const |
Returns the default callback function to use for a particular invalid geometry check. | |
Qgis::DistanceUnit | distanceUnit () const |
Returns the distance unit to use for distance calculations. | |
QString | ellipsoid () const |
Returns the ellipsoid to use for distance and area calculations. | |
QVariantMap | exportToMap () const |
Exports the context's settings to a variant map. | |
QgsExpressionContext & | expressionContext () |
Returns the expression context. | |
const QgsExpressionContext & | expressionContext () const |
Returns the expression context. | |
QgsProcessingFeedback * | feedback () |
Returns the associated feedback object. | |
QgsProcessingContext::Flags | flags () const |
Returns any flags set in the context. | |
QgsMapLayer * | getMapLayer (const QString &identifier) |
Returns a map layer from the context with a matching identifier. | |
std::function< void(const QgsFeature &) > | invalidGeometryCallback (QgsFeatureSource *source=nullptr) const |
Returns the callback function to use when encountering an invalid geometry and invalidGeometryCheck() is set to GeometryAbortOnInvalid. | |
Qgis::InvalidGeometryCheck | invalidGeometryCheck () const |
Returns the behavior used for checking invalid geometries in input layers. | |
QMap< QString, QgsProcessingContext::LayerDetails > | layersToLoadOnCompletion () const |
Returns a map of layers (by ID or datasource) to LayerDetails, to load into the canvas upon completion of the algorithm or model. | |
QgsProcessingContext::LayerDetails & | layerToLoadOnCompletionDetails (const QString &layer) |
Returns a reference to the details for a given layer which is loaded on completion of the algorithm or model. | |
Qgis::ProcessingLogLevel | logLevel () const |
Returns the logging level for algorithms to use when pushing feedback messages to users. | |
int | maximumThreads () const |
Returns the (optional) number of threads to use when running algorithms. | |
QgsProcessingModelInitialRunConfig * | modelInitialRunConfig () |
Returns a reference to the model initial run configuration, used to run a model algorithm. | |
QgsProcessingModelResult & | modelResult () |
Returns a reference to the model results, populated when the context is used to run a model algorithm. | |
QgsProcessingModelResult | modelResult () const |
Returns the model results, populated when the context is used to run a model algorithm. | |
QgsProcessingContext & | operator= (const QgsProcessingContext &other)=delete |
QString | preferredRasterFormat () const |
Returns the preferred raster format to use for vector outputs. | |
QString | preferredVectorFormat () const |
Returns the preferred vector format to use for vector outputs. | |
QgsProject * | project () const |
Returns the project in which the algorithm is being executed. | |
void | pushToThread (QThread *thread) |
Pushes the thread affinity for the context (including all layers contained in the temporaryLayerStore()) into another thread. | |
void | setAreaUnit (Qgis::AreaUnit areaUnit) |
Sets the unit to use for area calculations. | |
void | setCurrentTimeRange (const QgsDateTimeRange ¤tTimeRange) |
Sets the current time range to use for temporal operations. | |
void | setDefaultEncoding (const QString &encoding) |
Sets the default encoding to use for newly created files. | |
void | setDistanceUnit (Qgis::DistanceUnit unit) |
Sets the unit to use for distance calculations. | |
void | setEllipsoid (const QString &ellipsoid) |
Sets a specified ellipsoid to use for distance and area calculations. | |
void | setExpressionContext (const QgsExpressionContext &context) |
Sets the expression context. | |
void | setFeedback (QgsProcessingFeedback *feedback) |
Sets an associated feedback object. | |
void | setFlags (QgsProcessingContext::Flags flags) |
Sets flags for the context. | |
void | setInvalidGeometryCallback (const std::function< void(const QgsFeature &) > &callback) |
Sets a callback function to use when encountering an invalid geometry and invalidGeometryCheck() is set to GeometryAbortOnInvalid. | |
void | setInvalidGeometryCheck (Qgis::InvalidGeometryCheck check) |
Sets the behavior used for checking invalid geometries in input layers. | |
void | setLayersToLoadOnCompletion (const QMap< QString, QgsProcessingContext::LayerDetails > &layers) |
Sets the map of layers (by ID or datasource) to LayerDetails, to load into the canvas upon completion of the algorithm or model. | |
void | setLogLevel (Qgis::ProcessingLogLevel level) |
Sets the logging level for algorithms to use when pushing feedback messages to users. | |
void | setMaximumThreads (int threads) |
Sets the (optional) number of threads to use when running algorithms. | |
void | setModelInitialRunConfig (std::unique_ptr< QgsProcessingModelInitialRunConfig > config) |
Sets the model initial run configuration, used to run a model algorithm. | |
void | setPreferredRasterFormat (const QString &format) |
Sets the preferred raster format to use for vector outputs. | |
void | setPreferredVectorFormat (const QString &format) |
Sets the preferred vector format to use for vector outputs. | |
void | setProject (QgsProject *project) |
Sets the project in which the algorithm will be executed. | |
void | setTemporaryFolder (const QString &folder) |
Sets the (optional) temporary folder to use when running algorithms. | |
void | setTransformContext (const QgsCoordinateTransformContext &context) |
Sets the coordinate transform context. | |
void | setTransformErrorCallback (const std::function< void(const QgsFeature &) > &callback) |
Sets a callback function to use when encountering a transform error when iterating features. | |
std::unique_ptr< QgsProcessingModelInitialRunConfig > | takeModelInitialRunConfig () |
Takes the model initial run configuration from the context. | |
QgsMapLayer * | takeResultLayer (const QString &id) |
Takes the result map layer with matching id from the context and transfers ownership of it back to the caller. | |
void | takeResultsFrom (QgsProcessingContext &context) |
Takes the results from another context and merges them with the results currently stored in this context. | |
QString | temporaryFolder () const |
Returns the (optional) temporary folder to use when running algorithms. | |
QgsMapLayerStore * | temporaryLayerStore () |
Returns a reference to the layer store used for storing temporary layers during algorithm execution. | |
QThread * | thread () |
Returns the thread in which the context lives. | |
QgsCoordinateTransformContext | transformContext () const |
Returns the coordinate transform context. | |
std::function< void(const QgsFeature &) > | transformErrorCallback () const |
Returns the callback function to use when encountering a transform error when iterating features. | |
bool | willLoadLayerOnCompletion (const QString &layer) const |
Returns true if the given layer (by ID or datasource) will be loaded into the current project upon completion of the algorithm or model. | |
Contains information about the context in which a processing algorithm is executed.
Contextual information includes settings such as the associated project, and expression context.
Definition at line 44 of file qgsprocessingcontext.h.
typedef QFlags< Flag > QgsProcessingContext::Flags |
Definition at line 54 of file qgsprocessingcontext.h.
typedef QFlags< ProcessArgumentFlag > QgsProcessingContext::ProcessArgumentFlags |
Definition at line 724 of file qgsprocessingcontext.h.
Flags that affect how processing algorithms are run.
Enumerator | |
---|---|
Unused | Temporary unused entry. |
Definition at line 49 of file qgsprocessingcontext.h.
|
strong |
Flags controlling the results given by asQgisProcessArguments().
Enumerator | |
---|---|
IncludeProjectPath | Include the associated project path argument. |
Definition at line 720 of file qgsprocessingcontext.h.
QgsProcessingContext::QgsProcessingContext | ( | ) |
Definition at line 28 of file qgsprocessingcontext.cpp.
|
delete |
QgsProcessingContext::~QgsProcessingContext | ( | ) |
Definition at line 41 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::addLayerToLoadOnCompletion | ( | const QString & | layer, |
const QgsProcessingContext::LayerDetails & | details | ||
) |
Adds a layer to load (by ID or datasource) into the canvas upon completion of the algorithm or model.
The details parameter dictates the LayerDetails.
Definition at line 66 of file qgsprocessingcontext.cpp.
Qgis::AreaUnit QgsProcessingContext::areaUnit | ( | ) | const |
Returns the area unit to use for area calculations.
Definition at line 254 of file qgsprocessingcontext.cpp.
QStringList QgsProcessingContext::asQgisProcessArguments | ( | QgsProcessingContext::ProcessArgumentFlags | flags = QgsProcessingContext::ProcessArgumentFlags() | ) | const |
Returns list of the equivalent qgis_process arguments representing the settings from the context.
Definition at line 190 of file qgsprocessingcontext.cpp.
|
inline |
Copies all settings which are safe for use across different threads from other to this context.
Definition at line 67 of file qgsprocessingcontext.h.
QgsDateTimeRange QgsProcessingContext::currentTimeRange | ( | ) | const |
Returns the current time range to use for temporal operations.
Definition at line 224 of file qgsprocessingcontext.cpp.
|
inline |
Returns the default encoding to use for newly created files.
Definition at line 492 of file qgsprocessingcontext.h.
std::function< void(const QgsFeature &)> QgsProcessingContext::defaultInvalidGeometryCallbackForCheck | ( | Qgis::InvalidGeometryCheck | check, |
QgsFeatureSource * | source = nullptr |
||
) | const |
Returns the default callback function to use for a particular invalid geometry check.
Definition at line 89 of file qgsprocessingcontext.cpp.
Qgis::DistanceUnit QgsProcessingContext::distanceUnit | ( | ) | const |
Returns the distance unit to use for distance calculations.
Definition at line 244 of file qgsprocessingcontext.cpp.
QString QgsProcessingContext::ellipsoid | ( | ) | const |
Returns the ellipsoid to use for distance and area calculations.
Definition at line 234 of file qgsprocessingcontext.cpp.
QVariantMap QgsProcessingContext::exportToMap | ( | ) | const |
Exports the context's settings to a variant map.
Definition at line 175 of file qgsprocessingcontext.cpp.
|
inline |
Returns the expression context.
Definition at line 135 of file qgsprocessingcontext.h.
|
inline |
Returns the expression context.
Definition at line 140 of file qgsprocessingcontext.h.
|
inline |
Returns the associated feedback object.
Definition at line 504 of file qgsprocessingcontext.h.
|
inline |
Returns any flags set in the context.
Definition at line 95 of file qgsprocessingcontext.h.
QgsMapLayer * QgsProcessingContext::getMapLayer | ( | const QString & | identifier | ) |
Returns a map layer from the context with a matching identifier.
This method considers layer IDs, names and sources when matching the identifier (see QgsProcessingUtils::mapLayerFromString() for details).
Ownership is not transferred and remains with the context.
Definition at line 135 of file qgsprocessingcontext.cpp.
std::function< void(const QgsFeature &)> QgsProcessingContext::invalidGeometryCallback | ( | QgsFeatureSource * | source = nullptr | ) | const |
Returns the callback function to use when encountering an invalid geometry and invalidGeometryCheck() is set to GeometryAbortOnInvalid.
Definition at line 81 of file qgsprocessingcontext.cpp.
|
inline |
Returns the behavior used for checking invalid geometries in input layers.
Definition at line 407 of file qgsprocessingcontext.h.
|
inline |
Returns a map of layers (by ID or datasource) to LayerDetails, to load into the canvas upon completion of the algorithm or model.
Definition at line 347 of file qgsprocessingcontext.h.
|
inline |
Returns a reference to the details for a given layer which is loaded on completion of the algorithm or model.
Definition at line 398 of file qgsprocessingcontext.h.
Qgis::ProcessingLogLevel QgsProcessingContext::logLevel | ( | ) | const |
Returns the logging level for algorithms to use when pushing feedback messages to users.
Definition at line 145 of file qgsprocessingcontext.cpp.
int QgsProcessingContext::maximumThreads | ( | ) | const |
Returns the (optional) number of threads to use when running algorithms.
Definition at line 165 of file qgsprocessingcontext.cpp.
QgsProcessingModelInitialRunConfig * QgsProcessingContext::modelInitialRunConfig | ( | ) |
Returns a reference to the model initial run configuration, used to run a model algorithm.
This may be nullptr
, e.g. when the context is not being used to run a model.
Definition at line 314 of file qgsprocessingcontext.cpp.
|
inline |
Returns a reference to the model results, populated when the context is used to run a model algorithm.
Definition at line 795 of file qgsprocessingcontext.h.
|
inline |
Returns the model results, populated when the context is used to run a model algorithm.
Definition at line 785 of file qgsprocessingcontext.h.
|
delete |
|
inline |
Returns the preferred raster format to use for vector outputs.
This method returns a file extension to use when creating raster outputs (e.g. "tif"). Generally, it is preferable to use the extension associated with a particular parameter, which can be retrieved through QgsProcessingDestinationParameter::defaultFileExtension(). However, in some cases, a specific parameter may not be available to call this method on (e.g. for an algorithm which has only an output folder parameter and which creates multiple output layers in that folder). In this case, the format returned by this function should be used when creating these outputs.
It is the algorithm's responsibility to check whether the returned format is acceptable for the algorithm, and to provide an appropriate fallback when the returned format is not usable.
Definition at line 621 of file qgsprocessingcontext.h.
|
inline |
Returns the preferred vector format to use for vector outputs.
This method returns a file extension to use when creating vector outputs (e.g. "shp"). Generally, it is preferable to use the extension associated with a particular parameter, which can be retrieved through QgsProcessingDestinationParameter::defaultFileExtension(). However, in some cases, a specific parameter may not be available to call this method on (e.g. for an algorithm which has only an output folder parameter and which creates multiple output layers in that folder). In this case, the format returned by this function should be used when creating these outputs.
It is the algorithm's responsibility to check whether the returned format is acceptable for the algorithm, and to provide an appropriate fallback when the returned format is not usable.
Definition at line 584 of file qgsprocessingcontext.h.
|
inline |
Returns the project in which the algorithm is being executed.
Definition at line 107 of file qgsprocessingcontext.h.
|
inline |
Pushes the thread affinity for the context (including all layers contained in the temporaryLayerStore()) into another thread.
This method is only safe to call when the current thread matches the existing thread affinity for the context (see thread()).
Definition at line 528 of file qgsprocessingcontext.h.
void QgsProcessingContext::setAreaUnit | ( | Qgis::AreaUnit | areaUnit | ) |
Sets the unit to use for area calculations.
If not explicitly set, the unit will default to the project()'s area unit setting.
Definition at line 259 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setCurrentTimeRange | ( | const QgsDateTimeRange & | currentTimeRange | ) |
Sets the current time range to use for temporal operations.
Definition at line 229 of file qgsprocessingcontext.cpp.
|
inline |
Sets the default encoding to use for newly created files.
Definition at line 498 of file qgsprocessingcontext.h.
void QgsProcessingContext::setDistanceUnit | ( | Qgis::DistanceUnit | unit | ) |
Sets the unit to use for distance calculations.
If not explicitly set, the unit will default to the project()'s distance unit setting.
Definition at line 249 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setEllipsoid | ( | const QString & | ellipsoid | ) |
Sets a specified ellipsoid to use for distance and area calculations.
If not explicitly set, the ellipsoid will default to the project()'s ellipsoid setting.
Definition at line 239 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setExpressionContext | ( | const QgsExpressionContext & | context | ) |
Sets the expression context.
Definition at line 49 of file qgsprocessingcontext.cpp.
|
inline |
Sets an associated feedback object.
This allows context related functions to report feedback and errors to users and processing logs. While ideally this feedback object should outlive the context, only a weak pointer to feedback is stored and no errors will occur if feedback is deleted before the context. Ownership of feedback is not transferred.
Definition at line 514 of file qgsprocessingcontext.h.
|
inline |
|
inline |
Sets a callback function to use when encountering an invalid geometry and invalidGeometryCheck() is set to GeometryAbortOnInvalid.
This function will be called using the feature with invalid geometry as a parameter.
Definition at line 424 of file qgsprocessingcontext.h.
void QgsProcessingContext::setInvalidGeometryCheck | ( | Qgis::InvalidGeometryCheck | check | ) |
Sets the behavior used for checking invalid geometries in input layers.
Settings this to anything but QgsFeatureRequest::GeometryNoCheck will also reset the invalidGeometryCallback() to a default implementation.
Definition at line 74 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setLayersToLoadOnCompletion | ( | const QMap< QString, QgsProcessingContext::LayerDetails > & | layers | ) |
Sets the map of layers (by ID or datasource) to LayerDetails, to load into the canvas upon completion of the algorithm or model.
Definition at line 56 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setLogLevel | ( | Qgis::ProcessingLogLevel | level | ) |
Sets the logging level for algorithms to use when pushing feedback messages to users.
Definition at line 150 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setMaximumThreads | ( | int | threads | ) |
Sets the (optional) number of threads to use when running algorithms.
If set, this overrides the standard global Processing number of threads setting. Note that if algorithm implementation does not support multhreaded execution, this setting will be ignored.
Definition at line 170 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::setModelInitialRunConfig | ( | std::unique_ptr< QgsProcessingModelInitialRunConfig > | config | ) |
Sets the model initial run configuration, used to run a model algorithm.
Definition at line 319 of file qgsprocessingcontext.cpp.
|
inline |
Sets the preferred raster format to use for vector outputs.
This method sets a file extension to use when creating raster outputs (e.g. "tif"). Generally, it is preferable to use the extension associated with a particular parameter, which can be retrieved through QgsProcessingDestinationParameter::defaultFileExtension(). However, in some cases, a specific parameter may not be available to call this method on (e.g. for an algorithm which has only an output folder parameter and which creates multiple output layers in that folder). In this case, the format set by this function will be used when creating these outputs.
Definition at line 638 of file qgsprocessingcontext.h.
|
inline |
Sets the preferred vector format to use for vector outputs.
This method sets a file extension to use when creating vector outputs (e.g. "shp"). Generally, it is preferable to use the extension associated with a particular parameter, which can be retrieved through QgsProcessingDestinationParameter::defaultFileExtension(). However, in some cases, a specific parameter may not be available to call this method on (e.g. for an algorithm which has only an output folder parameter and which creates multiple output layers in that folder). In this case, the format set by this function will be used when creating these outputs.
Definition at line 601 of file qgsprocessingcontext.h.
|
inline |
Sets the project in which the algorithm will be executed.
This also automatically sets the transformContext(), ellipsoid(), distanceUnit() and areaUnit() to match the project's settings.
Definition at line 117 of file qgsprocessingcontext.h.
void QgsProcessingContext::setTemporaryFolder | ( | const QString & | folder | ) |
Sets the (optional) temporary folder to use when running algorithms.
If set, this overrides the standard global Processing temporary folder and should be used for all temporary files created during algorithm execution.
Definition at line 160 of file qgsprocessingcontext.cpp.
|
inline |
Sets the coordinate transform context.
Note that setting a project for the context will automatically set the coordinate transform context.
Definition at line 161 of file qgsprocessingcontext.h.
|
inline |
Sets a callback function to use when encountering a transform error when iterating features.
This function will be called using the feature which encountered the transform error as a parameter.
Definition at line 463 of file qgsprocessingcontext.h.
std::unique_ptr< QgsProcessingModelInitialRunConfig > QgsProcessingContext::takeModelInitialRunConfig | ( | ) |
Takes the model initial run configuration from the context.
May return nullptr
, e.g. when the context is not being used to run a model.
Definition at line 324 of file qgsprocessingcontext.cpp.
QgsMapLayer * QgsProcessingContext::takeResultLayer | ( | const QString & | id | ) |
Takes the result map layer with matching id from the context and transfers ownership of it back to the caller.
This method can be used to remove temporary layers which are not required for further processing from a context.
Definition at line 140 of file qgsprocessingcontext.cpp.
void QgsProcessingContext::takeResultsFrom | ( | QgsProcessingContext & | context | ) |
Takes the results from another context and merges them with the results currently stored in this context.
This includes settings like any layers loaded in the temporaryLayerStore() and layersToLoadOnCompletion(). This is only safe to call when both this context and the other context share the same thread() affinity, and that thread is the current thread.
Definition at line 127 of file qgsprocessingcontext.cpp.
QString QgsProcessingContext::temporaryFolder | ( | ) | const |
Returns the (optional) temporary folder to use when running algorithms.
If set, this overrides the standard global Processing temporary folder and should be used for all temporary files created during algorithm execution.
Definition at line 155 of file qgsprocessingcontext.cpp.
|
inline |
Returns a reference to the layer store used for storing temporary layers during algorithm execution.
Definition at line 241 of file qgsprocessingcontext.h.
|
inline |
Returns the thread in which the context lives.
Definition at line 520 of file qgsprocessingcontext.h.
|
inline |
Returns the coordinate transform context.
Definition at line 151 of file qgsprocessingcontext.h.
|
inline |
Returns the callback function to use when encountering a transform error when iterating features.
Definition at line 486 of file qgsprocessingcontext.h.
|
inline |
Returns true
if the given layer (by ID or datasource) will be loaded into the current project upon completion of the algorithm or model.
Definition at line 361 of file qgsprocessingcontext.h.