28.2.2. Raster conversion

28.2.2.1. gdal2xyz

Converts raster data to XYZ ASCII file format.

Parameters

Label

Name

Type

Description

Input layer

INPUT

[raster]

Raster layer to convert

Band number

BAND

[raster band]

Default: The first band of the input layer

If the raster is multiband, choose the band you want to convert

Source NoData

Optional

NODATA_INPUT

[number]

Default: None

Input pixel value to treat as “NoData” (GDAL >= 3.7).

Destination NoData

Optional

NODATA_OUTPUT

[number]

Default: None

Assign specified “NoData” value to output (GDAL >= 3.7).

Do not output NoData values

SKIP_NODATA

[boolean]

Default: False

Do not output “NoData” values (GDAL >= 3.3).

Output comma-separated values

CSV

[boolean]

Default: False

Sets whether the output file should be of type comma-separated values (csv).

XYZ ASCII file

OUTPUT

[file]

Default: [Save to temporary file]

Specification of the output file. One of:

  • Save to a Temporary File

  • Save to File…

Outputs

Label

Name

Type

Description

XYZ ASCII file

INPUT

[table]

Table file containing the values exported from the raster band.

Python code

Algorithm ID: gdal:gdal2xyz

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.2.2. PCT to RGB

Converts an 8 bit paletted image to a 24 bit RGB. It will convert a pseudocolor band from the input file to an RGB file of the desired format.

This algorithm is derived from the GDAL pct2rgb utility.

Default menu: Raster ► Conversion

Parameters

Label

Name

Type

Description

Input layer

INPUT

[raster]

Input 8 bit raster image

Band number

BAND

[raster band]

Default: The first band of the input layer

If the raster is multiband, choose the band you want to convert

Generate a RGBA file

RGBA

[boolean]

Default: False

Sets whether the output file should be of type RGBA.

PCT to RGB

OUTPUT

[file]

Default: [Save to temporary file]

Specification of the output file. One of:

  • Save to a Temporary File

  • Save to File…

Outputs

Label

Name

Type

Description

PCT to RGB

OUTPUT

[raster]

24 bit RGB raster image

Python code

Algorithm ID: gdal:pcttorgb

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.2.3. Polygonize (raster to vector)

Creates vector polygons for all connected regions of pixels in the raster sharing a common pixel value. Each polygon is created with an attribute indicating the pixel value of that polygon.

This algorithm is derived from the GDAL polygonize utility.

Default menu: Raster ► Conversion

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[raster]

Input raster layer

Band number

BAND

[raster band]

Default: The first band of the input layer

If the raster is multiband, choose the band you want to use

Name of the field to create

FIELD

[string]

Default: ‘DN’

Specify the field name for the attributes of the connected regions.

Use 8-connectedness

EIGHT_CONNECTEDNESS

[boolean]

Default: False

If not set, raster cells must have a common border to be considered connected (4-connected). If set, touching raster cells are also considered connected (8-connected).

Vectorized

OUTPUT

[vector: polygon]

Default: [Save to temporary file]

Specification of the output (polygon) vector layer. One of:

  • Save to a Temporary File

  • Save to File…

Advanced parameters

Label

Name

Type

Description

Additional command-line parameters

Optional

EXTRA

[string]

Default: None

Add extra GDAL command line options

Outputs

Label

Name

Type

Description

Vectorized

OUTPUT

[vector: polygon]

Output vector layer

Python code

Algorithm ID: gdal:polygonize

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.2.4. Rearrange bands

Creates a new raster using selected band(s) from a given raster layer. The algorithm also makes it possible to reorder the bands for the newly-created raster.

This algorithm is derived from the GDAL translate utility.

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[raster]

Input raster layer

Selected band(s)

BANDS

[raster band] [list]

Default: None

Ordered list of the bands to use to create the new raster

Converted

OUTPUT

[raster]

Default: [Save to temporary file]

Specification of the output raster. One of:

  • Save to a Temporary File

  • Save to File…

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: 0

Defines the data type of the output raster file. Options:

  • 0 — Use Input Layer Data Type

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

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

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

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

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

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

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

  • 8 — CInt16 (Complex Int16)

  • 9 — CInt32 (Complex Int32)

  • 10 — CFloat32 (Complex Float32)

  • 11 — CFloat64 (Complex Float64)

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

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

Outputs

Label

Name

Type

Description

Converted

OUTPUT

[raster]

Output raster layer with rearranged bands.

Python code

Algorithm ID: gdal:rearrange_bands

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.2.5. RGB to PCT

Converts a 24 bit RGB image into a 8 bit paletted. Computes an optimal pseudo-color table for the given RGB-image using a median cut algorithm on a downsampled RGB histogram. Then it converts the image into a pseudo-colored image using the color table. This conversion utilizes Floyd-Steinberg dithering (error diffusion) to maximize output image visual quality.

If you want to classify a raster map and want to reduce the number of classes it can be helpful to downsample your image with this algorithm before.

This algorithm is derived from the GDAL rgb2pct utility.

Default menu: Raster ► Conversion

Parameters

Label

Name

Type

Description

Input layer

INPUT

[raster]

Input (RGB) raster layer

Number of colors

NCOLORS

[number]

Default: 2

The number of colors the resulting image will contain. A value from 2-256 is possible.

RGB to PCT

OUTPUT

[raster]

Default: [Save to temporary file]

Specification of the output raster. One of:

  • Save to a Temporary File

  • Save to File…

Outputs

Label

Name

Type

Description

RGB to PCT

OUTPUT

[raster]

Output raster layer.

Python code

Algorithm ID: gdal:rgbtopct

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.2.6. Translate (convert format)

Converts raster data between different formats.

This algorithm is derived from the GDAL translate utility.

Default menu: Raster ► Conversion

Parameters

Basic parameters

Label

Name

Type

Description

Input layer

INPUT

[raster]

Input raster layer

Override the projection of the output file

Optional

TARGET_CRS

[crs]

Specify a projection for the output file

Assign a specified NoData value to output bands

Optional

NODATA

[number]

Default: Not set

Defines the value to use for NoData in the output raster

Copy all subdatasets of this file to individual output files

COPY_SUBDATASETS

[boolean]

Default: False

Create individual files for subdatasets

Converted

OUTPUT

[raster]

Default: [Save to temporary file]

Specification of the output (translated) raster layer. One of:

  • Save to a Temporary File

  • Save to File…

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 (|).

Additional command-line parameters

Optional

EXTRA

[string]

Default: None

Add extra GDAL command line options

Output data type

DATA_TYPE

[enumeration]

Default: 0

Defines the data type of the output raster file. Options:

  • 0 — Use Input Layer Data Type

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

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

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

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

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

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

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

  • 8 — CInt16 (Complex Int16)

  • 9 — CInt32 (Complex Int32)

  • 10 — CFloat32 (Complex Float32)

  • 11 — CFloat64 (Complex Float64)

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

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

Outputs

Label

Name

Type

Description

Converted

OUTPUT

[raster]

Output (translated) raster layer.

Python code

Algorithm ID: gdal:translate

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.