25.1.21. Tabela de vetores

25.1.21.1. Adicionar campo de autoincremento

Adiciona um novo campo inteiro a uma camada vetorial, com um valor sequencial para cada feição.

Este campo pode ser usado como um ID exclusivo para as feições da camada. O novo atributo não é adicionado à camada de entrada, mas uma nova camada é gerada.

O valor inicial para a série incremental pode ser especificado. Opcionalmente, a série incremental pode ser baseada em campos de agrupamento e uma ordem de classificação para feições também pode ser especificada.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The input vector layer.

Field name

FIELD_NAME

[string]

Padrão: ‘AUTO’

Name of the field with autoincremental values

Start values at

Opcional

START

[number]

Padrão: 0

Choose the initial number of the incremental count

Modulus value NEW in 3.22

Opcional

MODULUS

[number]

Padrão: 0

Specifying an optional modulus value will restart the count to START whenever the field value reaches the modulus value. 0 means no restart.

Group values by

Opcional

GROUP_FIELDS

[tablefield: any] [list]

Select grouping field(s): instead of a single count run for the whole layer, a separate count is processed for each value returned by the combination of these fields.

Sort expression

Opcional

SORT_EXPRESSION

[expression]

Use an expression to sort the features in the layer either globally or if set, based on group fields.

Ordernar ascendente

SORT_ASCENDING

[boolean]

Padrão: Verdadeiro

When a sort expression is set, use this option to control the order in which features are assigned values.

Sort nulls first

SORT_NULLS_FIRST

[boolean]

Padrão: Falso

When a sort expression is set, use this option to set whether Null values are counted first or last.

Incremented

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output vector layer with the auto increment field. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Incremented

SAÍDA

[same as input]

Vector layer with auto incremental field

Python code

Algorithm ID: native:addautoincrementalfield

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.

25.1.21.2. Adicionar um campo à tabela de atributos

Adds a new field to a vector layer.

The name and characteristics of the attribute are defined as parameters.

O novo atributo não é adicionado à camada de entrada, mas uma nova camada é gerada.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

A camada de entrada

Field name

FIELD_NAME

[string]

Name of the new field

Field type

FIELD_TYPE

[enumeration]

Padrão: 0

Tipo do novo campo. Você pode escolher entre:

  • 0 — Inteiro

  • 1 — Flutuante

  • 2 — Texto

Field length

FIELD_LENGTH

[number]

Padrão: 10

Length of the field

Field precision

FIELD_PRECISION

[number]

Padrão: 0

Precisão do campo. Usual com campo tipo flutuante.

Added

SAÍDA

[same as input]

Default: [Create temporary layer]

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

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Added

SAÍDA

[same as input]

Vector layer with new field added

Python code

Algorithm ID: native:addfieldtoattributestable

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.

25.1.21.3. Adicionar índice do campo valores únicos

Takes a vector layer and an attribute and adds a new numeric field.

Values in this field correspond to values in the specified attribute, so features with the same value for the attribute will have the same value in the new numeric field.

This creates a numeric equivalent of the specified attribute, which defines the same classes.

O novo atributo não é adicionado à camada de entrada, mas uma nova camada é gerada.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

A camada de entrada.

Class field

CAMPO

[tablefield: any]

Features that have the same value for this field will get the same index.

Output field name

FIELD_NAME

[string]

Default: ‘NUM_FIELD’

Name of the new field containing the indexes.

Layer with index field

SAÍDA

[vector: any]

Default: [Create temporary layer]

Vector layer with the numeric field containing indexes. One of:

  • Ignorar Saída

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

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

Class summary

SUMMARY_OUTPUT

[table]

Default: [Skip output]

Specify the table to contain the summary of the class field mapped to the corresponding unique value. One of:

  • Ignorar Saída

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • 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

Layer with index field

SAÍDA

[same as input]

Vector layer with the numeric field containing indexes.

Class summary

SUMMARY_OUTPUT

[table]

Table with summary of the class field mapped to the corresponding unique value.

Python code

Algorithm ID: native:adduniquevalueindexfield

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.

25.1.21.4. Add X/Y fields to layer

Adds X and Y (or latitude/longitude) fields to a point layer. The X/Y fields can be calculated in a different CRS to the layer (e.g. creating latitude/longitude fields for a layer in a projected CRS).

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: point]

A camada de entrada.

Coordinate system

SRC

[crs]

Default: “EPSG:4326”

Coordinate reference system to use for the generated x and y fields.

Field prefix

Opcional

PREFIX

[string]

Prefix to add to the new field names to avoid name collisions with fields in the input layer.

Added fields

SAÍDA

[vector: point]

Default: [Create temporary layer]

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

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Added fields

SAÍDA

[vector: point]

The output layer - identical to the input layer but with two new double fields, x and y.

Python code

Algorithm ID: native:addxyfieldstolayer

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.

25.1.21.5. Calculadora de campo avançada Python

Adds a new attribute to a vector layer, with values resulting from applying an expression to each feature.

The expression is defined as a Python function.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Camada vetorial de entrada

Result field name

FIELD_NAME

[string]

Default: ‘NewField’

Name of the new field

Field type

FIELD_TYPE

[enumeration]

Padrão: 0

Type of the new field. One of:

  • 0 — Inteiro

  • 1 — Flutuante

  • 2 — Texto

Field length

FIELD_LENGTH

[number]

Padrão: 10

Length of the field

Field precision

FIELD_PRECISION

[number]

Padrão: 3

Precisão do campo. Usual com campo tipo flutuante.

Global expression

Opcional

GLOBAL

[string]

The code in the global expression section will be executed only once before the calculator starts iterating through all the features of the input layer. Therefore, this is the correct place to import necessary modules or to calculate variables that will be used in subsequent calculations.

Formula

FORMULA

[string]

The Python formula to evaluate. Example: To calculate the area of an input polygon layer you can add:

value = $geom.area()

Calculado

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the vector layer with the new calculated field. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • 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

Calculado

SAÍDA

[same as input]

Vector layer with the new calculated field

Python code

Algorithm ID: qgis:advancedpythonfieldcalculator

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.

25.1.21.6. Descartar campo(s)

Takes a vector layer and generates a new one that has the same features but without the selected columns.

Ver também

Retain fields

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer to drop field(s) from

Fields to drop

COLUMN

[tablefield: any] [list]

The field(s) to drop

Remaining fields

SAÍDA

[same as input]

Default: [Create temporary layer]

Specify the output vector layer with the remaining fields. One of:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Remaining fields

SAÍDA

[same as input]

Vector layer with the remaining fields

Python code

Algorithm ID: native:deletecolumn

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.

25.1.21.7. Explode HStore Field

Creates a copy of the input layer and adds a new field for every unique key in the HStore field.

The expected field list is an optional comma separated list. If this list is specified, only these fields are added and the HStore field is updated. By default, all unique keys are added.

The PostgreSQL HStore is a simple key-value store used in PostgreSQL and OGR (when reading an OSM file with the other_tags field.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Camada vetorial de entrada

HStore field

CAMPO

[tablefield: any]

The field(s) to drop

Expected list of fields separated by a comma

Opcional

EXPECTED_FIELDS

[string]

Padrão: ‘’

Comma-separated list of fields to extract. The HStore field will be updated by removing these keys.

Exploded

SAÍDA

[same as input]

Default: [Create temporary layer]

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

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • 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

Exploded

SAÍDA

[same as input]

Output vector layer

Python code

Algorithm ID: native:explodehstorefield

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.

25.1.21.8. Extract binary field

Extracts contents from a binary field, saving them to individual files. Filenames can be generated using values taken from an attribute in the source table or based on a more complex expression.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

Input vector layer containing the binary data

Binary field

CAMPO

[tablefield: any]

Field containing the binary data

File name

FILENAME

[expression]

Field or expression-based text to name each output file

Destination folder

FOLDER

[folder]

Default: [Save to temporary folder]

Folder in which to store the output files. One of:

  • Salvar como Diretório Temporário

  • Save to Directory

Saídas

Etiqueta

Nome

Tipo

Descrição

Folder

FOLDER

[folder]

The folder that contains the output files.

Python code

Algorithm ID: native:extractbinary

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.

25.1.21.9. Calculadora de campo

Opens the field calculator (see Expressões). You can use all the supported expressions and functions.

A new layer is created with the result of the expression.

The field calculator is very useful when used in O modelador gráfico.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The layer to calculate on

Output field name

FIELD_NAME

[string]

The name of the field for the results

Output field type

FIELD_TYPE

[enumeration]

Padrão: 0

The type of the field. One of:

  • 0 — Float

  • 1 — Integer

  • 2 — Texto

  • 3 — Date

Output field width

FIELD_LENGTH

[number]

Padrão: 10

The length of the result field (minimum 0)

Field precision

FIELD_PRECISION

[number]

Padrão: 3

The precision of the result field (minimum 0, maximum 15)

Create new field

NEW_FIELD

[boolean]

Padrão: Verdadeiro

Should the result field be a new field

Formula

FORMULA

[expression]

The formula to use to calculate the result

Output file

SAÍDA

[vector: any]

Default: [Create temporary layer]

Specification of the output layer.

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Calculado

SAÍDA

[vector: any]

Output layer with the calculated field values

Python code

Algorithm ID: native:fieldcalculator

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.

25.1.21.10. Editar campos

Allows editing the structure of the attribute table of a vector layer.

Fields can be modified in their type and name, using a fields mapping.

The original layer is not modified. A new layer is generated, which contains a modified attribute table, according to the provided fields mapping.

Nota

When using a template layer with constraints on fields, the information is displayed in the widget with a coloured background and tooltip. Treat this information as a hint during configuration. No constraints will be added on an output layer nor will they be checked or enforced by the algorithm.

The Refactor fields algorithm allows to:

  • Change field names and types

  • Add and remove fields

  • Reordenar campos

  • Calcular novos campos baseado nas expressões

  • Load field list from another layer

../../../../_images/refactor_fields.png

Fig. 25.113 Refactor fields dialog

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The layer to modify

Fields mapping

FIELDS_MAPPING

[list]

List of output fields with their definitions. The embedded table lists all the fields of the source layer and allows you to edit them:

  • Click newAttribute to create a new field.

  • Click deleteAttribute to remove a field.

  • Use arrowUp and arrowDown to change the selected field order.

  • Click clearText to reset to the default view.

For each of the fields you’d like to reuse, you need to fill the following options:

Source expression (expression) [expression]

Campo ou expressão da camada de entrada

Field name (name) [string]

Name of the field in the output layer. By default input field name is kept.

Type (type) [enumeration]

Data type of the output field. Available types depend on the output layer provider.

Length (length) [number]

Comprimento do campo de saída.

Precision (precision) [number]

Precisão do campo de saída.

Constraints (constraints) [string]

When using a template layer, indicates whether there are constraints applied to the template field. Hover over the cell to display the constraints.

Load fields from template layer

Allows to select a layer from the current project as a template and (with Load fields) fill the above “Fields mapping” options with its fields and their definitions.

Refactored

SAÍDA

[vector: any]

Default: [Create temporary layer]

Especificação da camada de saída. Uma de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Refactored

SAÍDA

[vector: any]

Output layer with refactored fields

Python code

Algorithm ID: native:refactorfields

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.

25.1.21.11. Rename field

Renames an existing field from a vector layer.

The original layer is not modified. A new layer is generated where the attribute table contains the renamed field.

Ver também

Editar campos

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The input vector layer

Field to rename

CAMPO

[tablefield: any]

The field to be altered

New field name

NEW_NAME

[string]

The new field name

Renamed

SAÍDA

[vector: same as input]

Default: [Create temporary layer]

Especificação da camada de saída. Uma de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Renamed

SAÍDA

[vector: same as input]

Output layer with the renamed field

Python code

Algorithm ID: qgis:renametablefield

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.

25.1.21.12. Retain fields

NEW in 3.18

Takes a vector layer and generates a new one that retains only the selected fields. All other fields will be dropped.

Ver também

Descartar campo(s)

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The input vector layer

Fields to retain

FIELDS

[tablefield: any][list]

List of fields to keep in the layer

Retained fields

SAÍDA

[vector: same as input]

Default: [Create temporary layer]

Especificação da camada de saída. Uma de:

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Retained fields

SAÍDA

[vector: same as input]

Output layer with the retained fields

Python code

Algorithm ID: native:retainfields

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.

25.1.21.13. Texto para flutuante

Modifies the type of a given attribute in a vector layer, converting a text attribute containing numeric strings into a numeric attribute (e.g. ‘1’ to 1.0).

The algorithm creates a new vector layer so the source one is not modified.

If the conversion is not possible the selected column will have NULL values.

Parâmetros

Etiqueta

Nome

Tipo

Descrição

Camada de entrada

ENTRADA

[vector: any]

The input vector layer.

Text attribute to convert to float

CAMPO

[tablefield: string]

The string field for the input layer that is to be converted to a float field.

Float from text

SAÍDA

[same as input]

Default: [Create Temporary Layer]

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

  • Create Temporary Layer (TEMPORARY_OUTPUT)

  • Save to File…

  • Save to Geopackage…

  • Save to Database Table…

  • Append to Layer…

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

Saídas

Etiqueta

Nome

Tipo

Descrição

Float from text

SAÍDA

[same as input]

Output vector layer with the string field converted into a float field

Python code

Algorithm ID: qgis:texttofloat

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.