Class: QgsProcessingProvider¶
-
class
qgis.core.
QgsProcessingProvider
(parent: QObject = None)¶ Bases:
PyQt5.QtCore.QObject
Constructor for QgsProcessingProvider.
Abstract base class for processing providers. An algorithm provider is a set of related algorithms, typically from the same external application or related to a common area of analysis.
New in version 3.0.
- Parameters
parent –
-
addAlgorithm
(self, algorithm: QgsProcessingAlgorithm) → bool¶ Adds an
algorithm
to the provider. Ownership of the algorithm is transferred to the provider.- Parameters
algorithm (QgsProcessingAlgorithm) –
- Return type
bool
-
algorithm
(self, name: str) → QgsProcessingAlgorithm¶ Returns the matching algorithm by
name
, or a None if no matching algorithm is contained by this provider.See also
- Parameters
name (str) –
- Return type
-
algorithms
(self) → object¶ Returns a list of algorithms supplied by this provider.
See also
- Return type
object
-
algorithmsLoaded
¶ Emitted when the provider has loaded (or refreshed) its list of available algorithms.
See also
refreshAlgorithms()
[signal]
-
canBeActivated
(self) → bool¶ Returns true if the provider can be activated, or false if it cannot be activated (e.g. due to missing external dependencies).
See also
- Return type
bool
-
childEvent
()¶
-
connectNotify
()¶
-
customEvent
()¶
-
defaultRasterFileExtension
(self) → str¶ Returns the default file extension to use for raster outputs created by the provider.
The default implementation returns the user’s default Processing raster output format setting, if it’s supported by the provider (see supportedOutputRasterLayerExtensions()). Otherwise the first reported supported raster format will be used.
See also
- Return type
str
-
defaultVectorFileExtension
(self, hasGeometry: bool = True) → str¶ Returns the default file extension to use for vector outputs created by the provider.
If
hasGeometry
is true then the output file format must have support for geometry. IfhasGeometry
is false then non-spatial formats can be used.The default implementation returns the user’s default Processing vector output format setting, if it’s supported by the provider (see supportedOutputVectorLayerExtensions()). Otherwise the first reported supported vector format will be used.
See also
- Parameters
hasGeometry (bool = True) –
- Return type
str
-
disconnectNotify
()¶
-
helpId
(self) → str¶ Returns the provider help id string, used for creating
QgsHelp
urls for algorithms belong to this provider. By default, this returns an empty string, meaning that noQgsHelp
url should be created for the provider’s algorithms.See also
- Return type
str
-
icon
(self) → QIcon¶ Returns an icon for the provider.
See also
- Return type
QIcon
-
id
(self) → str¶ Returns the unique provider id, used for identifying the provider. This string should be a unique, short, character only string, eg “qgis” or “gdal”. This string should not be localised.
See also
See also
- Return type
str
-
isActive
(self) → bool¶ Returns true if the provider is active and able to run algorithms.
- Return type
bool
-
isSignalConnected
()¶
-
isSupportedOutputValue
(self, outputValue: Any, parameter: QgsProcessingDestinationParameter, context: QgsProcessingContext) → Tuple[bool, str]¶ Returns true if the specified
outputValue
is of a supported file format for the given destinationparameter
.If the output value is not supported,
error
will be set to a descriptive message explaining why.New in version 3.6.
- Parameters
outputValue (Any) –
parameter (QgsProcessingDestinationParameter) –
context (QgsProcessingContext) –
- Return type
Tuple[bool, str]
-
load
(self) → bool¶ Loads the provider. This will be called when the plugin is being loaded, and any general setup actions should occur in an overridden version of this method. Subclasses should not individually load any algorithms in their load() implementations, as that must occur within the loadAlgorithms() method. Instead, subclasses should call refreshAlgorithms() from any overloaded load() method to trigger an initial load of the provider’s algorithms.
- Return type
bool
- Returns
true if provider could be successfully loaded
See also
-
loadAlgorithms
(self)¶ Loads all algorithms belonging to this provider. Subclasses should implement this, calling addAlgorithm() to register all their associated algorithms.
-
longName
(self) → str¶ Returns the longer version of the provider name, which can include extra details such as version numbers. E.g. “Lastools LIDAR tools (version 2.2.1)”. This string should be localised.
The default implementation returns the same string as name().
See also
See also
- Return type
str
-
name
(self) → str¶ Returns the provider name, which is used to describe the provider within the GUI. This string should be short (e.g. “Lastools”) and localised.
See also
See also
- Return type
str
-
receivers
()¶
-
refreshAlgorithms
(self)¶ Refreshes the algorithms available from the provider, causing it to re-populate with all associated algorithms.
-
sender
()¶
-
senderSignalIndex
()¶
-
supportedOutputRasterLayerExtensions
(self) → List[str]¶ Returns a list of the raster format file extensions supported by this provider.
- Return type
List[str]
-
supportedOutputTableExtensions
(self) → List[str]¶ Returns a list of the table (geometry-less vector layers) file extensions supported by this provider.
By default this is the same as supportedOutputVectorLayerExtensions(). Providers which utilize different formats for geometry-less layers can override this method to return a different list of supported formats.
See also
See also
New in version 3.4.3.
- Return type
List[str]
-
supportedOutputVectorLayerExtensions
(self) → List[str]¶ Returns a list of the vector format file extensions supported by this provider.
See also
See also
See also
- Return type
List[str]
-
supportsNonFileBasedOutput
(self) → bool¶ Returns true if the provider supports non-file based outputs (such as memory layers or direct database outputs). If a provider returns false for this method than it indicates that none of the outputs from any of the provider’s algorithms have support for non-file based outputs. Returning true indicates that the algorithm’s parameters will each individually declare their non-file based support.
The default behavior for providers is to support non-file based outputs, and most providers which rely solely on QGIS API (and which do not depend on third-party scripts or external dependencies) will automatically support this.
- Return type
bool
-
svgIconPath
(self) → str¶ Returns a path to an SVG version of the provider’s icon.
See also
- Return type
str
-
timerEvent
()¶