QGIS API Documentation  3.4.15-Madeira (e83d02e274)
Public Types | Public Member Functions | List of all members
QgsRasterCalculator Class Reference

Performs raster layer calculations. More...

#include <qgsrastercalculator.h>

Public Types

enum  Result {
  Success = 0, CreateOutputError = 1, InputLayerError = 2, Canceled = 3,
  ParserError = 4, MemoryError = 5, BandError = 6
}
 Result of the calculation. More...
 

Public Member Functions

 QgsRasterCalculator (const QString &formulaString, const QString &outputFile, const QString &outputFormat, const QgsRectangle &outputExtent, int nOutputColumns, int nOutputRows, const QVector< QgsRasterCalculatorEntry > &rasterEntries)
 QgsRasterCalculator constructor. More...
 
 QgsRasterCalculator (const QString &formulaString, const QString &outputFile, const QString &outputFormat, const QgsRectangle &outputExtent, const QgsCoordinateReferenceSystem &outputCrs, int nOutputColumns, int nOutputRows, const QVector< QgsRasterCalculatorEntry > &rasterEntries)
 QgsRasterCalculator constructor. More...
 
QString lastError () const
 Returns a description of the last error encountered. More...
 
Result processCalculation (QgsFeedback *feedback=nullptr)
 Starts the calculation and writes a new raster. More...
 

Detailed Description

Performs raster layer calculations.

Definition at line 63 of file qgsrastercalculator.h.

Member Enumeration Documentation

Result of the calculation.

Enumerator
Success 

Calculation successful.

CreateOutputError 

Error creating output data file.

InputLayerError 

Error reading input layer.

Canceled 

User canceled calculation.

ParserError 

Error parsing formula.

MemoryError 

Error allocating memory for result.

BandError 

Invalid band number for input.

Definition at line 68 of file qgsrastercalculator.h.

Constructor & Destructor Documentation

QgsRasterCalculator::QgsRasterCalculator ( const QString &  formulaString,
const QString &  outputFile,
const QString &  outputFormat,
const QgsRectangle outputExtent,
int  nOutputColumns,
int  nOutputRows,
const QVector< QgsRasterCalculatorEntry > &  rasterEntries 
)

QgsRasterCalculator constructor.

Parameters
formulaStringformula for raster calculation
outputFileoutput file path
outputFormatoutput file format
outputExtentoutput extent. CRS for output is taken from first entry in rasterEntries.
nOutputColumnsnumber of columns in output raster
nOutputRowsnumber of rows in output raster
rasterEntrieslist of referenced raster layers

Definition at line 34 of file qgsrastercalculator.cpp.

QgsRasterCalculator::QgsRasterCalculator ( const QString &  formulaString,
const QString &  outputFile,
const QString &  outputFormat,
const QgsRectangle outputExtent,
const QgsCoordinateReferenceSystem outputCrs,
int  nOutputColumns,
int  nOutputRows,
const QVector< QgsRasterCalculatorEntry > &  rasterEntries 
)

QgsRasterCalculator constructor.

Parameters
formulaStringformula for raster calculation
outputFileoutput file path
outputFormatoutput file format
outputExtentoutput extent, CRS is specified by outputCrs parameter
outputCrsdestination CRS for output raster
nOutputColumnsnumber of columns in output raster
nOutputRowsnumber of rows in output raster
rasterEntrieslist of referenced raster layers
Since
QGIS 2.10

Definition at line 48 of file qgsrastercalculator.cpp.

Member Function Documentation

QString QgsRasterCalculator::lastError ( ) const

Returns a description of the last error encountered.

Since
QGIS 3.4

Definition at line 343 of file qgsrastercalculator.cpp.

QgsRasterCalculator::Result QgsRasterCalculator::processCalculation ( QgsFeedback feedback = nullptr)

Starts the calculation and writes a new raster.

The optional feedback argument can be used for progress reporting and cancellation support.

Returns
QgsRasterCalculator::Success in case of success. If an error is encountered then a description of the error can be obtained by calling lastError().

Definition at line 61 of file qgsrastercalculator.cpp.


The documentation for this class was generated from the following files: