27.2.2. Raster conversion

27.2.2.1. gdal2xyz

Converts raster data to XYZ ASCII file format.

Parameter

Bezeichnung	Name	Typ	Beschreibung
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
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…

Ausgaben

Bezeichnung	Name	Typ	Beschreibung
XYZ ASCII file	INPUT	[table]	Table file containing the values exported from the raster band.

Pythoncode

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 Verarbeitung Algorithmen von der Konsole aus verwenden for details on how to run processing algorithms from the Python console.

27.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

Parameter

Bezeichnung	Name	Typ	Beschreibung
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…

Ausgaben

Bezeichnung	Name	Typ	Beschreibung
PCT to RGB	OUTPUT	[raster]	24 bit RGB raster image

Pythoncode

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 Verarbeitung Algorithmen von der Konsole aus verwenden for details on how to run processing algorithms from the Python console.

27.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

Parameter

Basic parameters

Bezeichnung	Name	Typ	Beschreibung
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

Bezeichnung	Name	Typ	Beschreibung
Additional command-line parameters Optional	EXTRA	[string] Default: None	Add extra GDAL command line options

Ausgaben

Bezeichnung	Name	Typ	Beschreibung
Vectorized	OUTPUT	[vector: polygon]	Output vector layer

Pythoncode

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 Verarbeitung Algorithmen von der Konsole aus verwenden for details on how to run processing algorithms from the Python console.

27.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.

Parameter

Basic parameters

Bezeichnung	Name	Typ	Beschreibung
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

Bezeichnung	Name	Typ	Beschreibung
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) Available options depend on the GDAL version built with QGIS (see Help ► About menu)

Ausgaben

Bezeichnung	Name	Typ	Beschreibung
Converted	OUTPUT	[raster]	Output raster layer with rearranged bands.

Pythoncode

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 Verarbeitung Algorithmen von der Konsole aus verwenden for details on how to run processing algorithms from the Python console.

27.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

Parameter

Bezeichnung	Name	Typ	Beschreibung
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…

Ausgaben

Bezeichnung	Name	Typ	Beschreibung
RGB to PCT	OUTPUT	[raster]	Output raster layer.

Pythoncode

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 Verarbeitung Algorithmen von der Konsole aus verwenden for details on how to run processing algorithms from the Python console.

27.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

Parameter

Basic parameters

Bezeichnung	Name	Typ	Beschreibung
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

Bezeichnung	Name	Typ	Beschreibung
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) Available options depend on the GDAL version built with QGIS (see Help ► About menu)

Ausgaben

Bezeichnung	Name	Typ	Beschreibung
Converted	OUTPUT	[raster]	Output (translated) raster layer.

Pythoncode

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 Verarbeitung Algorithmen von der Konsole aus verwenden for details on how to run processing algorithms from the Python console.