Class: QgsProcessingParameters¶
-
class
qgis.core.
QgsProcessingParameters
¶ Bases:
sip.wrapper
A collection of utilities for working with parameters when running a processing algorithm.
Parameters are stored in a QVariantMap and referenced by a unique string key. The QVariants in parameters are not usually accessed directly, and instead the high level API provided through
QgsProcessingParameters
parameterAsString(), parameterAsDouble() are used instead.Parameters are evaluated using a provided
QgsProcessingContext
, allowing the evaluation to understand available map layers and expression contexts (for expression based parameters).Methods
Creates an autogenerated parameter description from a parameter
name
.Returns
True
if the parameter with matchingname
is a dynamic parameter, and must be evaluated once for every input feature processed.Evaluates the parameter with matching
definition
to a static boolean value.Evaluates the parameter with matching
definition
to a static boolean value.Returns the color associated with an point parameter value, or an invalid color if the parameter was not set.
Evaluates the parameter with matching
definition
to a source vector layer file path of compatible format.Evaluates the parameter with matching
definition
to a source vector layer file path and layer name of compatible format.Evaluates the parameter with matching
definition
to a coordinate reference system.Evaluates the parameter with matching
definition
to a static double value.Evaluates the parameter with matching
definition
to a enum value.Evaluates the parameter with matching
definition
to list of enum values.Evaluates the parameter with matching
definition
to an expression.Evaluates the parameter with matching
definition
to a rectangular extent.Returns the coordinate reference system associated with an extent parameter value.
Evaluates the parameter with matching
definition
to a rectangular extent, and returns a geometry covering this extent.Evaluates the parameter with matching
definition
to a list of fields.Evaluates the parameter with matching
definition
to a file/folder name.Evaluates the parameter with matching
definition
to a list of files (forQgsProcessingParameterMultipleLayers
in QgsProcessing:TypeFile mode).Evaluates the parameter with matching
definition
to a file based output destination.Evaluates the parameter with matching
definition
to a static integer value.Evaluates the parameter with matching
definition
to a list of integer values.Evaluates the parameter with matching
definition
to a map layer.Evaluates the parameter with matching
definition
to a list of map layers.Evaluates the parameter with matching
definition
to a print layout.Evaluates the parameter with matching
definition
to a print layout item, taken from the specifiedlayout
.Evaluates the parameter with matching
definition
to a matrix/table of values.Evaluates the parameter with matching
definition
andvalue
to a mesh layer.Evaluates the parameter with matching
definition
to a output layer destination.Evaluates the parameter with matching
definition
to a point.Returns the coordinate reference system associated with an point parameter value.
Evaluates the parameter with matching
definition
to a range of values.Evaluates the parameter with matching
definition
to a raster layer.Evaluates the parameter with matching
definition
to a feature sink.Evaluates the parameter with matching
definition
to a feature source.Evaluates the parameter with matching
definition
to a static string value.Evaluates the parameter with matching
definition
to a vector layer.Creates a new
QgsProcessingParameterDefinition
using the configuration from a supplied scriptcode
string.Creates a new
QgsProcessingParameterDefinition
using the configuration from a supplied variantmap
.-
descriptionFromName
(name: str) → str¶ Creates an autogenerated parameter description from a parameter
name
.- Parameters
name (str) –
- Return type
str
-
isDynamic
(parameters: Dict[str, Any], name: str) → bool¶ Returns
True
if the parameter with matchingname
is a dynamic parameter, and must be evaluated once for every input feature processed.- Parameters
parameters (Dict[str) –
name (str) –
- Return type
bool
-
parameterAsBool
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → bool¶ Evaluates the parameter with matching
definition
to a static boolean value.parameterAsBool(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> bool Evaluates the parameter with matchingdefinition
andvalue
to a static boolean value.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
bool
-
parameterAsBoolean
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → bool¶ Evaluates the parameter with matching
definition
to a static boolean value.New in version 3.8.
parameterAsBoolean(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> bool Evaluates the parameter with matchingdefinition
andvalue
to a static boolean value.New in version 3.8.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
bool
-
parameterAsColor
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QColor¶ Returns the color associated with an point parameter value, or an invalid color if the parameter was not set.
New in version 3.10.
parameterAsColor(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QColor Returns the color associated with an color parameter value, or an invalid color if the parameter was not set.New in version 3.10.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
QColor
-
parameterAsCompatibleSourceLayerPath
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext, compatibleFormats: Iterable[str], preferredFormat: str = '', feedback: QgsProcessingFeedback = None) → str¶ Evaluates the parameter with matching
definition
to a source vector layer file path of compatible format.If the parameter is evaluated to an existing layer, and that 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. 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, because shapefiles are the future (don’t believe the geopackage hype!).When an algorithm is capable of handling multi-layer input files (such as Geopackage), it is preferable to use parameterAsCompatibleSourceLayerPathAndLayerName() which may avoid conversion in more situations.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
compatibleFormats (Iterable[str]) –
preferredFormat (str = '') –
feedback (
QgsProcessingFeedback
= None) –
- Return type
str
-
parameterAsCompatibleSourceLayerPathAndLayerName
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext, compatibleFormats: Iterable[str], preferredFormat: str = '', feedback: QgsProcessingFeedback = None) → Tuple[str, str]¶ Evaluates the parameter with matching
definition
to a source vector layer file path and layer name of compatible format.If the parameter is evaluated to an existing layer, and that 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. 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, because shapefiles are the future (don’t believe the geopackage hype!).This method should be preferred over parameterAsCompatibleSourceLayerPath() when an algorithm is able to correctly handle files with multiple layers. Unlike parameterAsCompatibleSourceLayerPath(), it will not force a conversion in this case and will return the target layer name in the
layerName
argument.- Parameters
definition (QgsProcessingParameterDefinition) – associated parameter definition
parameters (Dict[str) – input parameter value map
context (QgsProcessingContext) – processing context
compatibleFormats (Iterable[str]) – a list of lowercase file extensions compatible with the algorithm
preferredFormat (str = '') – preferred format extension to use if conversion if required
feedback (
QgsProcessingFeedback
= None) – feedback object
- Return type
Tuple[str, str]
- Returns
path to source layer, or nearly converted compatible layer
layerName: will be set to the target layer name for multi-layer sources (e.g. Geopackage)
New in version 3.10.
-
parameterAsCrs
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsCoordinateReferenceSystem¶ Evaluates the parameter with matching
definition
to a coordinate reference system.parameterAsCrs(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsCoordinateReferenceSystem Evaluates the parameter with matchingdefinition
andvalue
to a coordinate reference system.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsDouble
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → float¶ Evaluates the parameter with matching
definition
to a static double value.parameterAsDouble(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> float Evaluates the parameter with matchingdefinition
andvalue
to a static double value.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
float
-
parameterAsEnum
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → int¶ Evaluates the parameter with matching
definition
to a enum value.parameterAsEnum(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> int Evaluates the parameter with matchingdefinition
andvalue
to a enum value.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
int
-
parameterAsEnums
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → List[int]¶ Evaluates the parameter with matching
definition
to list of enum values.parameterAsEnums(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> List[int] Evaluates the parameter with matchingdefinition
andvalue
to list of enum values.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
List[int]
-
parameterAsExpression
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → str¶ Evaluates the parameter with matching
definition
to an expression.parameterAsExpression(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> str Evaluates the parameter with matchingdefinitionand
value
to an expression.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
str
-
parameterAsExtent
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext, crs: QgsCoordinateReferenceSystem = QgsCoordinateReferenceSystem()) → QgsRectangle¶ Evaluates the parameter with matching
definition
to a rectangular extent.If
crs
is set, and the original coordinate reference system of the parameter can be determined, then the extent will be automatically reprojected so that it is in the specifiedcrs
. In this case the extent of the reproject rectangle will be returned.See also
See also
parameterAsExtent(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
, crs:QgsCoordinateReferenceSystem
= QgsCoordinateReferenceSystem()) -> QgsRectangle Evaluates the parameter with matchingdefinition
andvalue
to a rectangular extent.If
crs
is set, and the original coordinate reference system of the parameter can be determined, then the extent will be automatically reprojected so that it is in the specifiedcrs
. In this case the extent of the reproject rectangle will be returned.See also
See also
New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
crs (
QgsCoordinateReferenceSystem
= QgsCoordinateReferenceSystem()) –
- Return type
-
parameterAsExtentCrs
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsCoordinateReferenceSystem¶ Returns the coordinate reference system associated with an extent parameter value.
See also
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsExtentGeometry
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext, crs: QgsCoordinateReferenceSystem = QgsCoordinateReferenceSystem()) → QgsGeometry¶ Evaluates the parameter with matching
definition
to a rectangular extent, and returns a geometry covering this extent.If
crs
is set, and the original coordinate reference system of the parameter can be determined, then the extent will be automatically reprojected so that it is in the specifiedcrs
. Unlike parameterAsExtent(), the reprojected rectangle returned by this function will no longer be a rectangle itself (i.e. this method returns the geometry of the actual reprojected rectangle, while parameterAsExtent() returns just the extent of the reprojected rectangle).See also
See also
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
crs (
QgsCoordinateReferenceSystem
= QgsCoordinateReferenceSystem()) –
- Return type
-
parameterAsFields
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → List[str]¶ Evaluates the parameter with matching
definition
to a list of fields.parameterAsFields(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> List[str] Evaluates the parameter with matchingdefinition
andvalue
to a list of fields.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
List[str]
-
parameterAsFile
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → str¶ Evaluates the parameter with matching
definition
to a file/folder name.parameterAsFile(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> str Evaluates the parameter with matchingdefinition
andvalue
to a file/folder name.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
str
-
parameterAsFileList
(definition: QgsProcessingParameterDefinition, value: Any, context: QgsProcessingContext) → List[str]¶ Evaluates the parameter with matching
definition
to a list of files (forQgsProcessingParameterMultipleLayers
in QgsProcessing:TypeFile mode).New in version 3.10.
parameterAsFileList(definition:
QgsProcessingParameterDefinition
, parameters: Dict[str, Any], context:QgsProcessingContext
) -> List[str] Evaluates the parameter with matchingdefinition
to a list of files (forQgsProcessingParameterMultipleLayers
in QgsProcessing:TypeFile mode).New in version 3.10.
- Parameters
definition (QgsProcessingParameterDefinition) –
value (Any) –
context (QgsProcessingContext) –
- Return type
List[str]
-
parameterAsFileOutput
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → str¶ Evaluates the parameter with matching
definition
to a file based output destination.parameterAsFileOutput(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> str Evaluates the parameter with matchingdefinition
andvalue
to a file based output destination.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
str
-
parameterAsInt
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → int¶ Evaluates the parameter with matching
definition
to a static integer value.parameterAsInt(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> int Evaluates the parameter with matchingdefinition
andvalue
to a static integer value.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
int
-
parameterAsInts
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → List[int]¶ Evaluates the parameter with matching
definition
to a list of integer values.New in version 3.4.
parameterAsInts(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> List[int] Evaluates the parameter with matchingdefinition
andvalue
to a list of integer values.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
List[int]
-
parameterAsLayer
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsMapLayer¶ Evaluates the parameter with matching
definition
to a map layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.parameterAsLayer(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsMapLayer Evaluates the parameter with matchingdefinition
andvalue
to a map layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsLayerList
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → List[QgsMapLayer]¶ Evaluates the parameter with matching
definition
to a list of map layers.parameterAsLayerList(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> List[QgsMapLayer] Evaluates the parameter with matchingdefinition
andvalue
to a list of map layers.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
List[QgsMapLayer]
-
parameterAsLayout
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsPrintLayout¶ Evaluates the parameter with matching
definition
to a print layout.Warning
This method is not safe to run in a background thread, so it must either be used within a prepareAlgorithm implementation (which runs in the main thread), or the algorithm must return the FlagNoThreading flag.
New in version 3.8.
parameterAsLayout(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsPrintLayout Evaluates the parameter with matchingdefinition
andvalue
to a print layout.Warning
This method is not safe to run in a background thread, so it must either be used within a prepareAlgorithm implementation (which runs in the main thread), or the algorithm must return the FlagNoThreading flag.
New in version 3.8.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsLayoutItem
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext, layout: QgsPrintLayout) → QgsLayoutItem¶ Evaluates the parameter with matching
definition
to a print layout item, taken from the specifiedlayout
.Warning
This method is not safe to run in a background thread, so it must either be used within a prepareAlgorithm implementation (which runs in the main thread), or the algorithm must return the FlagNoThreading flag.
New in version 3.8.
parameterAsLayoutItem(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
, layout:QgsPrintLayout
) -> QgsLayoutItem Evaluates the parameter with matchingdefinition
andvalue
to a print layout, taken from the specifiedlayout
.Warning
This method is not safe to run in a background thread, so it must either be used within a prepareAlgorithm implementation (which runs in the main thread), or the algorithm must return the FlagNoThreading flag.
New in version 3.8.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
layout (QgsPrintLayout) –
- Return type
-
parameterAsMatrix
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → List[Any]¶ Evaluates the parameter with matching
definition
to a matrix/table of values. Tables are collapsed to a 1 dimensional list.parameterAsMatrix(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> List[Any] Evaluates the parameter with matchingdefinition
andvalue
to a matrix/table of values. Tables are collapsed to a 1 dimensional list.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
List[Any]
-
parameterAsMeshLayer
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsMeshLayer¶ Evaluates the parameter with matching
definition
andvalue
to a mesh layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.New in version 3.6.
parameterAsMeshLayer(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsMeshLayer Evaluates the parameter with matchingdefinition
andvalue
to a mesh layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.New in version 3.6.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsOutputLayer
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → str¶ Evaluates the parameter with matching
definition
to a output layer destination.parameterAsOutputLayer(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> str Evaluates the parameter with matchingdefinition
andvalue
to a output layer destination.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
str
-
parameterAsPoint
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext, crs: QgsCoordinateReferenceSystem = QgsCoordinateReferenceSystem()) → QgsPointXY¶ Evaluates the parameter with matching
definition
to a point.If
crs
is set then the point will be automatically reprojected so that it is in the specifiedcrs
.See also
parameterAsPoint(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
, crs:QgsCoordinateReferenceSystem
= QgsCoordinateReferenceSystem()) -> QgsPointXY Evaluates the parameter with matchingdefinition
andvalue
to a point.If
crs
is set then the point will be automatically reprojected so that it is in the specifiedcrs
.See also
New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
crs (
QgsCoordinateReferenceSystem
= QgsCoordinateReferenceSystem()) –
- Return type
-
parameterAsPointCrs
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsCoordinateReferenceSystem¶ Returns the coordinate reference system associated with an point parameter value.
See also
parameterAsPointCrs(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsCoordinateReferenceSystem Returns the coordinate reference system associated with an point parameter value.See also
New in version 3.8.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsRange
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → List[float]¶ Evaluates the parameter with matching
definition
to a range of values.parameterAsRange(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> List[float] Evaluates the parameter with matchingdefinition
andvalue
to a range of values.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
List[float]
-
parameterAsRasterLayer
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsRasterLayer¶ Evaluates the parameter with matching
definition
to a raster layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.parameterAsRasterLayer(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsRasterLayer Evaluates the parameter with matchingdefinition
andvalue
to a raster layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsSink
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], fields: QgsFields, geometryType: QgsWkbTypes.Type, crs: QgsCoordinateReferenceSystem, context: QgsProcessingContext, sinkFlags: Union[QgsFeatureSink.SinkFlags, QgsFeatureSink.SinkFlag] = 0) → Tuple[QgsFeatureSink, str]¶ Evaluates the parameter with matching
definition
to a feature sink.The
fields
,geometryType
andcrs
parameters dictate the properties of the resulting feature sink.Sinks will either be taken from
context
’s active project, or created from external providers and stored temporarily in thecontext
. ThedestinationIdentifier
argument will be set to a string which can be used to retrieve the layer corresponding to the sink, e.g. via callingQgsProcessingUtils.mapLayerFromString()
This function creates a new object and the caller takes responsibility for deleting the returned object.
parameterAsSink(definition:
QgsProcessingParameterDefinition
, value: Any, fields:QgsFields
, geometryType: QgsWkbTypes.Type, crs:QgsCoordinateReferenceSystem
, context:QgsProcessingContext
, sinkFlags: Union[QgsFeatureSink.SinkFlags, QgsFeatureSink.SinkFlag] = 0) -> Tuple[QgsFeatureSink
, str] Evaluates the parameter with matchingdefinition
andvalue
to a feature sink.The
fields
,geometryType
andcrs
parameters dictate the properties of the resulting feature sink.Sinks will either be taken from
context
’s active project, or created from external providers and stored temporarily in thecontext
. ThedestinationIdentifier
argument will be set to a string which can be used to retrieve the layer corresponding to the sink, e.g. via callingQgsProcessingUtils.mapLayerFromString()
This function creates a new object and the caller takes responsibility for deleting the returned object.
- Raises
: – py:class:QgsProcessingException
New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
fields (QgsFields) –
geometryType (QgsWkbTypes.Type) –
crs (QgsCoordinateReferenceSystem) –
context (QgsProcessingContext) –
sinkFlags (Union[QgsFeatureSink.SinkFlags) –
- Return type
Tuple[
QgsFeatureSink
, str]
-
parameterAsSource
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsProcessingFeatureSource¶ Evaluates the parameter with matching
definition
to a feature source.Sources will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
.This function creates a new object and the caller takes responsibility for deleting the returned object.
parameterAsSource(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsProcessingFeatureSource Evaluates the parameter with matchingdefinition
andvalue
to a feature source.Sources will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
.This function creates a new object and the caller takes responsibility for deleting the returned object.
New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterAsString
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → str¶ Evaluates the parameter with matching
definition
to a static string value.parameterAsString(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> str Evaluates the parameter with matchingdefinition
andvalue
to a static string value.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
str
-
parameterAsVectorLayer
(definition: QgsProcessingParameterDefinition, parameters: Dict[str, Any], context: QgsProcessingContext) → QgsVectorLayer¶ Evaluates the parameter with matching
definition
to a vector layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.parameterAsVectorLayer(definition:
QgsProcessingParameterDefinition
, value: Any, context:QgsProcessingContext
) -> QgsVectorLayer Evaluates the parameter with matchingdefinition
andvalue
to a vector layer.Layers will either be taken from
context
’s active project, or loaded from external sources and stored temporarily in thecontext
. In either case, callers do not need to handle deletion of the returned layer.New in version 3.4.
- Parameters
definition (QgsProcessingParameterDefinition) –
parameters (Dict[str) –
context (QgsProcessingContext) –
- Return type
-
parameterFromScriptCode
(code: str) → QgsProcessingParameterDefinition¶ Creates a new
QgsProcessingParameterDefinition
using the configuration from a supplied scriptcode
string. The caller takes responsibility for deleting the returned object.- Parameters
code (str) –
- Return type
-
parameterFromVariantMap
(map: Dict[str, Any]) → QgsProcessingParameterDefinition¶ Creates a new
QgsProcessingParameterDefinition
using the configuration from a supplied variantmap
. The caller takes responsibility for deleting the returned object.- Parameters
map (Dict[str) –
- Return type
-