28.2.6. Vector conversion

28.2.6.1. Convert format

Converts any OGR-supported vector layer into another OGR-supported format.

This algorithm is derived from the ogr2ogr utility.

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[vector: any]

Input vector layer

Convert all layers from dataset

CONVERT_ALL_LAYERS

[boolean]

Default: False

Converts the whole dataset. Supported output formats for this option are GPKG and GML.

Converted

OUTPUT

[same as input]

Specification of the output vector layer. One of:

  • Save to a Temporary File

  • Save to File…

For Save to File, the output format has to be specified. All GDAL vector formats are supported. For Save to a Temporary File the QGIS default vector format will be used.

Advanced parameters

Label

Name

Type

Description

Additional creation options

Optional

OPTIONS

[string]

Default: ‘’ (no additional options)

Additional GDAL creation options.

Outputs

Label

Name

Type

Description

Converted

OUTPUT

[same as input]

The output vector layer

Python code

Algorithm ID: gdal:convertformat

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 Using processing algorithms from the console for details on how to run processing algorithms from the Python console.

28.2.6.2. Rasterize (overwrite with attribute)

Overwrites a raster layer with values from a vector layer. New values are assigned based on the attribute value of the overlapping vector feature.

This algorithm is derived from the GDAL rasterize utility.

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[vector: any]

Input vector layer

Input raster layer

INPUT_RASTER

[raster]

Input raster layer

Field to use for a burn-in value

Optional

FIELD

[tablefield: numeric]

Defines the attribute field to use to set the pixels values

Advanced parameters

Label

Name

Type

Description

Add burn in values to existing raster values

ADD

[boolean]

Default: False

If False, pixels are assigned the selected field’s value. If True, the selected field’s value is added to the value of the input raster layer.

Additional command-line parameters

Optional

EXTRA

[string]

Default: ‘’

Add extra GDAL command line options

Outputs

Label

Name

Type

Description

Rasterized

OUTPUT

[raster]

The overwritten input raster layer

Python code

Algorithm ID: gdal:rasterize_over

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 Using processing algorithms from the console for details on how to run processing algorithms from the Python console.

28.2.6.3. Rasterize (overwrite with fixed value)

Overwrites parts of a raster layer with a fixed value. The pixels to overwrite are chosen based on the supplied (overlapping) vector layer.

This algorithm is derived from the GDAL rasterize utility.

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[vector: any]

Input vector layer

Input raster layer

INPUT_RASTER

[raster]

Input raster layer

A fixed value to burn

BURN

[number]

Default: 0.0

The value to burn

Advanced parameters

Label

Name

Type

Description

Add burn in values to existing raster values

ADD

[boolean]

Default: False

If False, pixels are assigned the fixed value. If True, the fixed value is added to the value of the input raster layer.

Additional command-line parameters

Optional

EXTRA

[string]

Default: ‘’

Add extra GDAL command line options

Outputs

Label

Name

Type

Description

Rasterized

OUTPUT

[raster]

The overwritten input raster layer

Python code

Algorithm ID: gdal:rasterize_over_fixed_value

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 Using processing algorithms from the console for details on how to run processing algorithms from the Python console.

28.2.6.4. Rasterize (vector to raster)

Converts vector geometries (points, lines and polygons) into a raster image.

This algorithm is derived from the GDAL rasterize utility.

Default menu: Raster ► Conversion

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[vector: any]

Input vector layer

Field to use for a burn-in value

Optional

FIELD

[tablefield: numeric]

Defines the attribute field from which the attributes for the pixels should be chosen

A fixed value to burn

Optional

BURN

[number]

Default: 0.0

A fixed value to burn into a band for all features.

Burn value extracted from the “Z” values of the feature

Optional

USE_Z

[boolean]

Default: False

Indicates that a burn value should be extracted from the “Z” values of the feature. Works with points and lines (linear interpolation along each segment). For polygons, works properly only if they are flat (same Z value for all vertices)

Output raster size units

UNITS

[enumeration]

Default: 0

Units to use when defining the output raster size/resolution. One of:

  • 0 — Pixels

  • 1 — Georeferenced units

Width/Horizontal resolution

WIDTH

[number]

Default: 0.0

Sets the width (if size units is “Pixels”) or horizontal resolution (if size units is “Georeferenced units”) of the output raster. Minimum value: 0.0.

Height/Vertical resolution

HEIGHT

[number]

Default: 0.0

Sets the height (if size units is “Pixels”) or vertical resolution (if size units is “Georeferenced units”) of the output raster.

Output extent

Optional

EXTENT

[extent]

Extent of the output raster layer. If the extent is not specified, the minimum extent that covers the selected reference layer(s) will be used.

Available methods are:

  • Calculate from layer…: uses extent of a layer loaded in the current project

  • Calculate from layout map…: uses extent of a layout map item in the active project

  • Calculate from bookmark…: uses extent of a saved bookmark

  • Use map canvas extent

  • Draw on canvas: click and drag a rectangle delimiting the area to take into account

  • Enter the coordinates as xmin, xmax, ymin, ymax

Assign a specified NoData value to output bands

Optional

NODATA

[number]

Default: 0.0

Assigns a specified NoData value to output bands

Rasterized

OUTPUT

[raster]

Default: [Save to temporary file]

Specification of the output raster layer. One of:

  • Save to a Temporary File

  • Save to File…

For Save to File, the output format has to be specified. All GDAL raster formats are supported. For Save to a Temporary File the QGIS default raster format will be used.

Advanced parameters

Label

Name

Type

Description

Additional creation options

Optional

OPTIONS

[string]

Default: ‘’

For adding one or more creation options that control the raster to be created (colors, block size, file compression…). For convenience, you can rely on predefined profiles (see GDAL driver options section).

Batch Process and Model Designer: separate multiple options with a pipe character (|).

Output data type

DATA_TYPE

[enumeration]

Default: 5

Defines the format of the output raster file.

Options:

  • 0 — Byte (Eight bit unsigned integer (quint8))

  • 1 — Int16 (Sixteen bit signed integer (qint16))

  • 2 — UInt16 (Sixteen bit unsigned integer (quint16))

  • 3 — UInt32 (Thirty two bit unsigned integer (quint32))

  • 4 — Int32 (Thirty two bit signed integer (qint32))

  • 5 — Float32 (Thirty two bit floating point (float))

  • 6 — Float64 (Sixty four bit floating point (double))

  • 7 — CInt16 (Complex Int16)

  • 8 — CInt32 (Complex Int32)

  • 9 — CFloat32 (Complex Float32)

  • 10 — CFloat64 (Complex Float64)

  • 11 — Int8 (Eight bit signed integer (qint8))

Available options depend on the GDAL version built with QGIS (see Help ► About menu)

Pre-initialize the output image with value

Optional

INIT

[number]

Pre-initializes the output image bands with this value. Not marked as the NoData value in the output file. The same value is used in all the bands.

Invert rasterization

INVERT

[boolean]

Default: False

Burns the fixed burn value, or the burn value associated with the first feature into all parts of the image not inside the provided polygon.

Additional command-line parameters

Optional

EXTRA

[string]

Default: ‘’

Add extra GDAL command line options

Outputs

Label

Name

Type

Description

Rasterized

OUTPUT

[raster]

Output raster layer

Python code

Algorithm ID: gdal:rasterize

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 Using processing algorithms from the console for details on how to run processing algorithms from the Python console.