24.1.15. Vector general

24.1.15.1. Assign projection

Assigns a new projection to a vector layer.

It creates a new layer with the exact same features and geometries as the input one, but assigned to a new CRS. The geometries are not reprojected, they are just assigned to a different CRS.

This algorithm can be used to repair layers which have been assigned an incorrect projection.

Attributes are not modified by this algorithm.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Vector layer with wrong or missing CRS

Assigned CRS

SRC

[crs]

Default: EPSG:4326 - WGS84

Select the new CRS to assign to the vector layer

Assigned CRS

Opcional

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output layer containing only the duplicates. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Assigned CRS

SAÍDA

[same as input]

Vector layer with assigned projection

Python code

Algorithm ID: native:assignprojection

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.2. Convert layer to spatial bookmarks

Creates spatial bookmarks corresponding to the extent of features contained in a layer.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: line, polygon]

A camada vetorial de entrada

Bookmark destination

DESTINATION

[enumeration]

Padrão: 0

Select the destination for the bookmarks. One of:

  • 0 — Project bookmarks

  • 1 — User bookmarks

Name field

NAME_EXPRESSION

[expression]

Field or expression that will give names to the generated bookmarks

Group field

GROUP_EXPRESSION

[expression]

Field or expression that will provide groups for the generated bookmarks

Saídas

Etiqueta

Nome

Tipo

Descrição

Count of bookmarks added

COUNT

[number]

Python code

Algorithm ID: native:layertobookmarks

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.3. Convert spatial bookmarks to layer

Creates a new layer containing polygon features for stored spatial bookmarks. The export can be filtered to only bookmarks belonging to the current project, to all user bookmarks, or a combination of both.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Bookmark source

SOURCE

[enumeration] [list]

Default: [0,1]

Select the source(s) of the bookmarks. One or more of:

  • 0 — Project bookmarks

  • 1 — User bookmarks

SRC de Saída

SRC

[crs]

Default: EPSG:4326 - WGS 84

O SRC da camada de saída

Saída

SAÍDA

[vector: polygon]

Default: [Create temporary layer]

Especifique a camada da linha de saída. Um de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Saída

SAÍDA

[vector: polygon]

The output (bookmarks) vector layer

Python code

Algorithm ID: native:bookmarkstolayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.4. Create attribute index

Creates an index against a field of the attribute table to speed up queries. The support for index creation depends on both the layer’s data provider and the field type.

No outputs are created: the index is stored on the layer itself.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Select the vector layer you want to create an attribute index for

Attribute to index

CAMPO

[tablefield: any]

Field of the vector layer

Saídas

Etiqueta

Nome

Tipo

Descrição

Indexed layer

SAÍDA

[same as input]

A copy of the input vector layer with an index for the specified field

Python code

Algorithm ID: native:createattributeindex

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.5. Create spatial index

Creates an index to speed up access to the features in a layer based on their spatial location. Support for spatial index creation is dependent on the layer’s data provider.

No new output layers are created.

Default menu: Vector ► Data Management Tools

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Camada vetorial de entrada

Saídas

Etiqueta

Nome

Tipo

Descrição

Indexed layer

SAÍDA

[same as input]

A copy of the input vector layer with a spatial index

Python code

Algorithm ID: native:createspatialindex

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.6. Define Shapefile projection

Sets the CRS (projection) of an existing Shapefile format dataset to the provided CRS. It is very useful when a Shapefile format dataset is missing the prj file and you know the correct projection.

Contrary to the Assign projection algorithm, it modifies the current layer and will not output a new layer.

Nota

For Shapefile datasets, the .prj and .qpj files will be overwritten - or created if missing - to match the provided CRS.

Default menu: Vector ► Data Management Tools

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Vector layer with missing projection information

CRS

SRC

[crs]

Select the CRS to assign to the vector layer

Saídas

Etiqueta

Nome

Tipo

Descrição

ENTRADA

[same as input]

The input vector layer with the defined projection

Python code

Algorithm ID: qgis:definecurrentprojection

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.7. Delete duplicate geometries

Finds and removes duplicated geometries.

Attributes are not checked, so in case two features have identical geometries but different attributes, only one of them will be added to the result layer.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The layer with duplicate geometries you want to clean

Cleaned

SAÍDA

[same as input]

Default: [Create temporary layer]

Especifique a camada da linha de saída. Um de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Count of discarded duplicate records

DUPLICATE_COUNT

[number]

Count of discarded duplicate records

Cleaned

SAÍDA

[same as input]

The output layer without any duplicated geometries

Count of retained records

RETAINED_COUNT

[number]

Count of unique records

Python code

Algorithm ID: native:deleteduplicategeometries

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.8. Delete duplicates by attribute

Deletes duplicate rows by only considering the specified field / fields. The first matching row will be retained, and duplicates will be discarded.

Optionally, these duplicate records can be saved to a separate output for analysis.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

A camada de entrada

Fields to match duplicates by

CAMPOS

[tablefield: any] [list]

Fields defining duplicates. Features with identical values for all these fields are considered duplicates.

Filtered (no duplicates)

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output layer containing the unique features. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Filtered (duplicates)

Opcional

DUPLICATES

[same as input]

Default: [Skip output]

Specify the output layer containing only the duplicates. One of:

  • Ignorar saída

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Filtered (duplicates)

Opcional

DUPLICATES

[same as input]

Default: [Skip output]

Vector layer containing the removed features. Will not be produced if not specified (left as [Skip output]).

Count of discarded duplicate records

DUPLICATE_COUNT

[number]

Count of discarded duplicate records

Filtered (no duplicates)

SAÍDA

[same as input]

Vector layer containing the unique features.

Count of retained records

RETAINED_COUNT

[number]

Count of unique records

Python code

Algorithm ID: native:removeduplicatesbyattribute

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.9. Detect dataset changes

Compares two vector layers, and determines which features are unchanged, added or deleted between the two. It is designed for comparing two different versions of the same dataset.

../../../../_images/detect_change.png

Fig. 24.38 Detect dataset change example

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Original layer

ORIGINAL

[vector: any]

The vector layer considered as the original version

Revised layer

REVISED

[vector: any]

The revised or modified vector layer

Attributes to consider for match

Opcional

COMPARE_ATTRIBUTES

[tablefield: any] [list]

Attributes to consider for match. By default, all attributes are compared.

Geometry comparison behavior

Opcional

MATCH_TYPE

[enumeration]

Padrão: 1

Defines the criteria for comparison. Options:

  • 0 — Exact Match: includes the order and vertices count of geometries

  • 1 — Tolerant Match (Topological Equality): geometries are considered equal

Unchanged features

UNCHANGED

[vector: same as Original layer]

Specify the output vector layer containing the unchanged features. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Added features

ADDED

[vector: same as Original layer]

Specify the output vector layer containing the added features. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Deleted features

DELETED

[vector: same as Original layer]

Specify the output vector layer containing the deleted features. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Unchanged features

UNCHANGED

[vector: same as Original layer]

Vector layer containing the unchanged features.

Added features

ADDED

[vector: same as Original layer]

Vector layer containing the added features.

Deleted features

DELETED

[vector: same as Original layer]

Vector layer containing the deleted features.

Count of unchanged features

UNCHANGED_COUNT

[number]

Count of unchanged features.

Count of features added in revised layer

ADDED_COUNT

[number]

Count of features added in revised layer.

Count of features deleted from original layer

DELETED_COUNT

[number]

Count of features deleted from original layer.

Python code

Algorithm ID: native:detectvectorchanges

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.10. Drop geometries

Creates a simple geometryless copy of the input layer attribute table. It keeps the attribute table of the source layer.

If the file is saved in a local folder, you can choose between many file formats.

checkbox Permite features in-place modification

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

A camada vetorial de entrada

Dropped geometries

SAÍDA

[table]

Specify the output geometryless layer. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Dropped geometries

SAÍDA

[table]

The output geometryless layer. A copy of the original attribute table.

Python code

Algorithm ID: native:dropgeometries

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.11. Executar SQL

Runs a simple or complex query with SQL syntax on the source layer.

Input datasources are identified with input1, input2inputN and a simple query will look like SELECT * FROM input1.

Beside a simple query, you can add expressions or variables within the SQL query parameter itself. This is particulary useful if this algorithm is executed within a Processing model and you want to use a model input as a parameter of the query. An example of a query will then be SELECT * FROM [% @table %] where @table is the variable that identifies the model input.

The result of the query will be added as a new layer.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Additional input datasources (called input1, .., inputN in the query)

INPUT_DATASOURCES

[vector: any] [list]

List of layers to query. In the SQL editor you can refer these layers with their real name or also with input1, input2, inputN depending on how many layers have been chosen.

SQL query

INPUT_QUERY

[string]

Type the string of your SQL query, e.g. SELECT * FROM input1.

Unique identifier field

Opcional

INPUT_UID_FIELD

[string]

Specify the column with unique ID

Geometry field

Opcional

INPUT_GEOMETRY_FIELD

[string]

Specify the geometry field

Tipo de Geometria

Opcional

INPUT_GEOMETRY_TYPE

[enumeration]

Padrão: 0

Choose the geometry of the result. By default the algorithm will autodetect it. One of:

  • 0 — Autodetect

  • 1 — No geometry

  • 2 — Point

  • 3 — LineString

  • 4 — Polygon

  • 5 — MultiPoint

  • 6 — MultiLineString

  • 7 — MultiPolygon

CRS

Opcional

INPUT_GEOMETRY_CRS

[crs]

The CRS to assign to the output layer

SQL Output

SAÍDA

[vector: any]

Default: [Create temporary layer]

Specify the output layer created by the query. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

SQL Output

SAÍDA

[vector: any]

Camada vetorial criada pela consulta

Python code

Algorithm ID: qgis:executesql

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.12. Extract selected features

Saves the selected features as a new layer.

Nota

If the selected layer has no selected features, the newly created layer will be empty.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Layer to save the selection from

Selected features

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the vector layer for the selected features. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Selected features

SAÍDA

[same as input]

Vector layer with only the selected features, or no feature if none was selected.

Python code

Algorithm ID: native:saveselectedfeatures

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.13. Extract Shapefile encoding

Extracts the attribute encoding information embedded in a Shapefile. Both the encoding specified by an optional .cpg file and any encoding details present in the .dbf LDID header block are considered.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

ESRI Shapefile (.SHP) Layer to extract the encoding information.

Saídas

Etiqueta

Nome

Tipo

Descrição

Shapefile encoding

ENCODING

[string]

Encoding information specified in the input file

CPG encoding

CPG_ENCODING

[string]

Encoding information specified in any optional .CPG file

LDID encoding

LDID_ENCODING

[string]

Encoding information specified in .dbf LDID header block

Python code

Algorithm ID: native:shpencodinginfo

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.14. Find projection

Creates a shortlist of candidate coordinate reference systems, for instance for a layer with an unknown projection.

The area that the layer is expected to cover must be specified via the target area parameter. The coordinate reference system for this target area must be known to QGIS.

The algorithm operates by testing the layer’s extent in every known reference system and then listing any for which the bounds would be near the target area if the layer was in this projection.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Layer with unknown projection

Target area for layer (xmin, xmax, ymin, ymax)

TARGET_AREA

[extent]

The area that the layer covers. The options for specifying the extent are:

  • Use Canvas Extent

  • Select Extent on Canvas

  • Use Layer Extent

It is also possible to provide the extent coordinates directly (xmin, xmax, ymin, ymax).

CRS candidates

SAÍDA

[table]

Default: [Create temporary layer]

Specify the table (geometryless layer) for the CRS suggestions (EPSG codes). One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

CRS candidates

SAÍDA

[table]

A table with all the CRS (EPSG codes) of the matching criteria.

Python code

Algorithm ID: qgis:findprojection

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.15. Flatten relationship

Flattens a relationship for a vector layer, exporting a single layer containing one parent feature per related child feature. This master feature contains all the attributes for the related features. This allows to have the relation as a plain table that can be e.g. exported to CSV.

../../../../_images/flatten_relationship.png

Fig. 24.39 Form of a region with related children (left) - A duplicate region feature for each related child, with joined attributes (right)

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Layer with the relationship that should be de-normalized

Flattened Layer

Opcional

SAÍDA

[same as input]

Default: [Save to temporary file]

Specify the output (flattened) layer. One of:

  • Save to a Temporary File

  • Salvar para Arquivo…

  • Save To GeoPackage…

  • Save to Database Table…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Flattened layer

SAÍDA

[same as input]

A layer containing master features with all the attributes for the related features

Python code

Algorithm ID: native:flattenrelationships

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.16. Join attributes by field value

Takes an input vector layer and creates a new vector layer that is an extended version of the input one, with additional attributes in its attribute table.

The additional attributes and their values are taken from a second vector layer. An attribute is selected in each of them to define the join criteria.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer. The output layer will consist of the features of this layer with attributes from matching features in the second layer.

Table field

CAMPO

[tablefield: any]

Field of the source layer to use for the join

Input layer 2

INPUT_2

[vector: any]

Layer with the attribute table to join

Table field 2

FIELD_2

[tablefield: any]

Field of the second (join) layer to use for the join The type of the field must be equal to (or compatible with) the input table field type.

Layer 2 fields to copy

Opcional

FIELDS_TO_COPY

[tablefield: any] [list]

Select the specific fields you want to add. By default all the fields are added.

Join type

MÉTODO

[enumeration]

Padrão: 1

The type of the final joined layer. One of:

  • 0 — Create separate feature for each matching feature (one-to-many)

  • 1 — Take attributes of the first matching feature only (one-to-one)

Discard records which could not be joined

DISCARD_NONMATCHING

[boolean]

Padrão: Verdadeiro

Check if you don’t want to keep the features that could not be joined

Joined field prefix

Opcional

PREFIX

[string]

Add a prefix to joined fields in order to easily identify them and avoid field name collision

Joined layer

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output vector layer for the join. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Unjoinable features from first layer

NON_MATCHING

[same as input]

Default: [Skip output]

Specify the output vector layer for unjoinable features from first layer. One of:

  • Ignorar saída

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Number of joined features from input table

JOINED_COUNT

[number]

Unjoinable features from first layer

Opcional

NON_MATCHING

[same as input]

Vector layer with the non-matched features

Joined layer

SAÍDA

[same as input]

Output vector layer with added attributes from the join

Number of unjoinable features from input table

Opcional

UNJOINABLE_COUNT

[number]

Python code

Algorithm ID: native:joinattributestable

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.17. Join attributes by location

Takes an input vector layer and creates a new vector layer that is an extended version of the input one, with additional attributes in its attribute table.

The additional attributes and their values are taken from a second vector layer. A spatial criteria is applied to select the values from the second layer that are added to each feature from the first layer.

Default menu: Vector ► Data Management Tools

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer. The output layer will consist of the features of this layer with attributes from matching features in the second layer.

Join layer

JOIN

[vector: any]

The attributes of this vector layer will be added to the source layer attribute table.

Geometric predicate

PREDICATE

[enumeration] [list]

Padrão: [0]

Select the geometric criteria. One or more of:

  • 0 — intersects

  • 1 — contains

  • 2 — equals

  • 3 — touches

  • 4 — overlaps

  • 5 — within

  • 6 — crosses

Fields to add (leave empty to use all fields)

Opcional

JOIN_FIELDS

[tablefield: any] [list]

Select the specific fields you want to add. By default all the fields are added.

Join type

MÉTODO

[enumeration]

The type of the final joined layer. One of:

  • 0 — Create separate feature for each matching feature (one-to-many)

  • 1 — Take attributes of the first matching feature only (one-to-one)

  • 2 — Take attributes of the feature with largest overlap only (one-to-one)

Discard records which could not be joined

DISCARD_NONMATCHING

[boolean]

Padrão: Falso

Remove from the output the input layer records which could not be joined

Joined field prefix

Opcional

PREFIX

[string]

Add a prefix to joined fields in order to easily identify them and avoid field name collision

Joined layer

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output vector layer for the join. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Unjoinable features from first layer

NON_MATCHING

[same as input]

Default: [Skip output]

Specify the output vector layer for unjoinable features from first layer. One of:

  • Ignorar saída

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Number of joined features from input table

JOINED_COUNT

[number]

Unjoinable features from first layer

Opcional

NON_MATCHING

[same as input]

Vector layer of the non-matched features

Joined layer

SAÍDA

[same as input]

Output vector layer with added attributes from the join

Python code

Algorithm ID: native:joinattributesbylocation

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.18. Join attributes by location (summary)

Takes an input vector layer and creates a new vector layer that is an extended version of the input one, with additional attributes in its attribute table.

The additional attributes and their values are taken from a second vector layer. A spatial criteria is applied to select the values from the second layer that are added to each feature from the first layer.

The algorithm calculates a statistical summary for the values from matching features in the second layer (e.g. maximum value, mean value, etc).

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer. The output layer will consist of the features of this layer with attributes from matching features in the second layer.

Join layer

JOIN

[vector: any]

The attributes of this vector layer will be added to the source layer attribute table.

Geometric predicate

PREDICATE

[enumeration] [list]

Padrão: [0]

Select the geometric criteria. One or more of:

  • 0 — intersects

  • 1 — contains

  • 2 — equals

  • 3 — touches

  • 4 — overlaps

  • 5 — within

  • 6 — crosses

Fields to summarize (leave empty to use all fields)

Opcional

JOIN_FIELDS

[tablefield: any] [list]

Select the specific fields you want to add and summarize. By default all the fields are added.

Summaries to calculate (leave empty to use all fields)

Opcional

SUMMARIES

[enumeration] [list]

Padrão: []

Choose which type of summary you want to add to each field and for each feature. One or more of:

  • 0 — count

  • 1 — unique

  • 2 — min

  • 3 — max

  • 4 — range

  • 5 — sum

  • 6 — mean

  • 7 — median

  • 8 — stddev

  • 9 — minority

  • 10 — majority

  • 11 — q1

  • 12 — q3

  • 13 — iqr

  • 14 — empty

  • 15 — filled

  • 16 — min_length

  • 17 — max_length

  • 18 — mean_length

Discard records which could not be joined

DISCARD_NONMATCHING

[boolean]

Padrão: Falso

Remove from the output the input layer records which could not be joined

Joined layer

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output vector layer for the join. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Joined layer

SAÍDA

[same as input]

Output vector layer with summarized attributes from the join

Python code

Algorithm ID: qgis:joinbylocationsummary

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.19. Join attributes by nearest

Takes an input vector layer and creates a new vector layer with additional fields in its attribute table. The additional attributes and their values are taken from a second vector layer. Features are joined by finding the closest features from each layer.

By default only the nearest feature is joined, but the join can also join to the k-nearest neighboring features.

If a maximum distance is specified, only features which are closer than this distance will be matched.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

A camada de entrada.

Input layer 2

INPUT_2

[vector: any]

The join layer.

Layer 2 fields to copy (leave empty to copy all fields)

FIELDS_TO_COPY

[fields]

Join layer fields to copy (if empty, all fields will be copied).

Discard records which could not be joined

DISCARD_NONMATCHING

[boolean]

Padrão: Falso

Remove from the output the input layer records which could not be joined

Joined field prefix

PREFIX

[string]

Joined field prefix

Maximum nearest neighbors

NEIGHBORS

[number]

Padrão: 1

Maximum number of nearest neighbors

Maximum distance

MAX_DISTANCE

[number]

Maximum search distance

Joined layer

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the vector layer containing the joined features. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Unjoinable features from first layer

NON_MATCHING

[same as input]

Default: [Skip output]

Specify the vector layer containing the features that could not be joined. One of:

  • Ignorar saída

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Joined layer

SAÍDA

[same as input]

The output joined layer.

Unjoinable features from first layer

NON_MATCHING

[same as input]

Layer containing the features from first layer that could not be joined to any features in the join layer.

Number of joined features from input table

JOINED_COUNT

[number]

Number of features from the input table that have been joined.

Number of unjoinable features from input table

UNJOINABLE_COUNT

[number]

Number of features from the input table that could not be joined.

Python code

Algorithm ID: native:joinbynearest

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.20. Merge vector layers

Combines multiple vector layers of the same geometry type into a single one.

The attribute table of the resulting layer will contain the fields from all input layers. If fields with the same name but different types are found then the exported field will be automatically converted into a string type field. New fields storing the original layer name and source are also added.

If any input layers contain Z or M values, then the output layer will also contain these values. Similarly, if any of the input layers are multi-part, the output layer will also be a multi-part layer.

Optionally, the destination coordinate reference system (CRS) for the merged layer can be set. If it is not set, the CRS will be taken from the first input layer. All layers will be reprojected to match this CRS.

../../../../_images/merge_vector_layers.png

Default menu: Vector ► Data Management Tools

Ver também

Split vector layer

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Input Layers

CAMADAS

[vector: any] [list]

The layers that are to be merged into a single layer. Layers should be of the same geometry type.

Destination CRS

Opcional

SRC

[crs]

Choose the CRS for the output layer. If not specified, the CRS of the first input layer is used.

Mesclado

SAÍDA

[same as input]

Default: [Create temporary layer]

Especifique a camada vetorial de saída. Uma de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Mesclado

SAÍDA

[same as input]

Output vector layer containing all the features and attributes from the input layers.

Python code

Algorithm ID: native:mergevectorlayers

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.21. Order by expression

Sorts a vector layer according to an expression: changes the feature index according to an expression.

Be careful, it might not work as expected with some providers, the order might not be kept every time.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer to sort

Expressão

EXPRESSÃO

[expression]

Expression to use for the sorting

Ordernar ascendente

ASCENDING

[boolean]

Padrão: Verdadeiro

If checked the vector layer will be sorted from small to large values.

Sort nulls first

NULLS_FIRST

[boolean]

Padrão: Falso

If checked, Null values are placed first

Ordered

SAÍDA

[same as input]

Default: [Create temporary layer]

Especifique a camada vetorial de saída. Uma de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Ordered

SAÍDA

[same as input]

Output (sorted) vector layer

Python code

Algorithm ID: native:orderbyexpression

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.22. Repair Shapefile

Repairs a broken ESRI Shapefile dataset by (re)creating the SHX file.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Input Shapefile

ENTRADA

[file]

Full path to the ESRI Shapefile dataset with a missing or broken SHX file

Saídas

Etiqueta

Nome

Tipo

Descrição

Repaired layer

SAÍDA

[vector: any]

The input vector layer with the SHX file repaired

Python code

Algorithm ID: native:repairshapefile

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.23. Reproject layer

Reprojects a vector layer in a different CRS. The reprojected layer will have the same features and attributes of the input layer.

checkbox Permite features in-place modification

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer to reproject

SRC Alvo

SRC_ALVO

[crs]

Default: EPSG:4326 - WGS 84

Destination coordinate reference system

Coordinate Operation

Opcional

OPERATION

[string]

Specific operation to use for a particular reprojection task, instead of always forcing use of the current project’s transformation settings. Useful when reprojecting a particular layer and control over the exact transformation pipeline is required. Requires proj version >= 6.

Read more at Datum Transformations.

Reprojetado

SAÍDA

[same as input]

Default: [Create temporary layer]

Especifique a camada vetorial de saída. Uma de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Reprojetado

SAÍDA

[same as input]

Output (reprojected) vector layer

Python code

Algorithm ID: native:reprojectlayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.24. Save vector features to file

Saves vector features to a specified file dataset.

For dataset formats supporting layers, an optional layer name parameter can be used to specify a custom string. Optional GDAL-defined dataset and layer options can be specified. For more information on this, read the online GDAL documentation on the format.

Parâmetros

Basic parameters

Etiqueta

Nome

Tipo

Descrição

Vector features

ENTRADA

[vector: any]

Input vector layer.

Saved features

SAÍDA

[same as input]

Default: [Save to temporary file]

Specify the file to save the features to. One of:

  • Save to a Temporary File

  • Salvar para Arquivo…

Advanced parameters

Etiqueta

Nome

Tipo

Descrição

Layer name

Opcional

LAYER_NAME

[string]

Name to use for the output layer

GDAL dataset options

Opcional

DATASOURCE_OPTIONS

[string]

GDAL dataset creation options of the output format. Separate individual options with semicolons.

GDAL layer options

Opcional

LAYER_OPTIONS

[string]

GDAL layer creation options of the output format. Separate individual options with semicolons.

Saídas

Etiqueta

Nome

Tipo

Descrição

Saved features

SAÍDA

[same as input]

Vector layer with the saved features.

File name and path

FILE_PATH

[string]

Output file name and path.

Layer name

LAYER_NAME

[string]

Name of the layer, if any.

Python code

Algorithm ID: native:savefeatures

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.25. Set layer encoding

Sets the encoding used for reading a layer’s attributes. No permanent changes are made to the layer, rather it affects only how the layer is read during the current session.

Nota

Changing the encoding is only supported for some vector layer data sources.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Saved features

ENTRADA

[vector: any]

Vector layer to set the encoding.

Encoding

ENCODING

[string]

Text encoding to assign to the layer in the current QGIS session.

Saídas

Etiqueta

Nome

Tipo

Descrição

Output layer

SAÍDA

[same as input]

Input vector layer with the set encoding.

Python code

Algorithm ID: native:setlayerencoding

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.26. Split features by character

Features are split into multiple output features by splitting a field’s value at a specified character. For instance, if a layer contains features with multiple comma separated values contained in a single field, this algorithm can be used to split these values up across multiple output features. Geometries and other attributes remain unchanged in the output. Optionally, the separator string can be a regular expression for added flexibility.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Camada vetorial de entrada

Split using values in the field

CAMPO

[tablefield: any]

Field to use for splitting

Split value using character

CHAR

[string]

Character to use for splitting

Use regular expression separator

REGEX

[boolean]

Padrão: Falso

Split

SAÍDA

[same as input]

Default: Create temporary layer

Specify output vector layer. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Salvar para Arquivo…

  • Salvar para Geopackage…

  • Salvar para Tabela PostGIS…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Split

SAÍDA

[same as input]

A camada vetorial de saída.

Python code

Algorithm ID: native:splitfeaturesbycharacter

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.27. Split vector layer

Creates a set of vectors in an output folder based on an input layer and an attribute. The output folder will contain as many layers as the unique values found in the desired field.

The number of files generated is equal to the number of different values found for the specified attribute.

It is the opposite operation of merging.

Default menu: Vector ► Data Management Tools

Ver também

Merge vector layers

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Camada vetorial de entrada

Unique ID field

CAMPO

[tablefield: any]

Field to use for splitting

Diretório de saída

SAÍDA

[folder]

Default: [Save to temporary folder]

Specify the directory for the output layers. One of:

  • Salvar como Diretório Temporário

  • Salvar para Diretório…

A codificação do arquivo também pode ser alterada aqui.

Saídas

Etiqueta

Nome

Tipo

Descrição

Diretório de saída

SAÍDA

[folder]

The directory for the output layers

Output layers

OUTPUT_LAYERS

[same as input] [list]

The output vector layers resulting from the split.

Python code

Algorithm ID: native:splitvectorlayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.15.28. Truncate table

Truncates a layer, by deleting all features from within the layer.

Aviso

This algorithm modifies the layer in place, and deleted features cannot be restored!

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Camada vetorial de entrada

Saídas

Etiqueta

Nome

Tipo

Descrição

Truncated layer

SAÍDA

[folder]

The truncated (empty) layer

Python code

Algorithm ID: native:truncatetable

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.