QGIS API Documentation  3.37.0-Master (a5b4d9743e8)
Public Member Functions | Protected Member Functions | List of all members
QgsRuggednessFilter Class Reference

Calculates the ruggedness index based on a 3x3 moving window. More...

#include <qgsruggednessfilter.h>

Inheritance diagram for QgsRuggednessFilter:
Inheritance graph
[legend]

Public Member Functions

 QgsRuggednessFilter (const QString &inputFile, const QString &outputFile, const QString &outputFormat)
 
- Public Member Functions inherited from QgsNineCellFilter
 QgsNineCellFilter (const QString &inputFile, const QString &outputFile, const QString &outputFormat)
 Constructor that takes input file, output file and output format (GDAL string) More...
 
virtual ~QgsNineCellFilter ()=default
 
double cellSizeX () const
 
double cellSizeY () const
 
double inputNodataValue () const
 
double outputNodataValue () const
 
int processRaster (QgsFeedback *feedback=nullptr)
 Starts the calculation, reads from mInputFile and stores the result in mOutputFile. More...
 
void setCellSizeX (double size)
 
void setCellSizeY (double size)
 
void setInputNodataValue (double value)
 
void setOutputNodataValue (double value)
 
void setZFactor (double factor)
 
double zFactor () const
 

Protected Member Functions

float processNineCellWindow (float *x11, float *x21, float *x31, float *x12, float *x22, float *x32, float *x13, float *x23, float *x33) override
 Calculates output value from nine input values. More...
 

Additional Inherited Members

- Protected Attributes inherited from QgsNineCellFilter
double mCellSizeX = -1.0
 
double mCellSizeY = -1.0
 
QString mInputFile
 
float mInputNodataValue = -1.0
 The nodata value of the input layer. More...
 
QString mOutputFile
 
QString mOutputFormat
 
float mOutputNodataValue = -1.0
 The nodata value of the output layer. More...
 
double mZFactor = 1.0
 Scale factor for z-value if x-/y- units are different to z-units (111120 for degree->meters and 370400 for degree->feet) More...
 

Detailed Description

Calculates the ruggedness index based on a 3x3 moving window.

Algorithm from Riley et al. 1999: A terrain ruggedness index that quantifies topographic heterogeneity

Definition at line 30 of file qgsruggednessfilter.h.

Constructor & Destructor Documentation

◆ QgsRuggednessFilter()

QgsRuggednessFilter::QgsRuggednessFilter ( const QString &  inputFile,
const QString &  outputFile,
const QString &  outputFormat 
)

Definition at line 21 of file qgsruggednessfilter.cpp.

Member Function Documentation

◆ processNineCellWindow()

float QgsRuggednessFilter::processNineCellWindow ( float *  x11,
float *  x21,
float *  x31,
float *  x12,
float *  x22,
float *  x32,
float *  x13,
float *  x23,
float *  x33 
)
overrideprotectedvirtual

Calculates output value from nine input values.

The input values and the output value can be equal to the nodata value if not present or outside of the border. Must be implemented by subclasses.

First index of the input cell is the row, second index is the column

Parameters
x11surrounding cell top left
x21surrounding cell central left
x31surrounding cell bottom left
x12surrounding cell top central
x22the central cell for which the value will be calculated
x32surrounding cell bottom central
x13surrounding cell top right
x23surrounding cell central right
x33surrounding cell bottom right
Returns
the calculated cell value for the central cell x22

Implements QgsNineCellFilter.

Definition at line 28 of file qgsruggednessfilter.cpp.


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