QGIS API Documentation 3.99.0-Master (26c88405ac0)
Loading...
Searching...
No Matches
qgsalgorithmrasterstatistics.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmrasterstatistics.cpp
3 ---------------------
4 begin : December 2019
5 copyright : (C) 2019 by Alexander Bruy
6 email : alexander dot bruy at gmail dot com
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
19
20#include <QTextStream>
21
23
24QString QgsRasterStatisticsAlgorithm::name() const
25{
26 return QStringLiteral( "rasterlayerstatistics" );
27}
28
29QString QgsRasterStatisticsAlgorithm::displayName() const
30{
31 return QObject::tr( "Raster layer statistics" );
32}
33
34QStringList QgsRasterStatisticsAlgorithm::tags() const
35{
36 return QObject::tr( "raster,stats,statistics,maximum,minimum,range,sum,mean,standard,deviation,summary" ).split( ',' );
37}
38
39QString QgsRasterStatisticsAlgorithm::group() const
40{
41 return QObject::tr( "Raster analysis" );
42}
43
44QString QgsRasterStatisticsAlgorithm::groupId() const
45{
46 return QStringLiteral( "rasteranalysis" );
47}
48
49QString QgsRasterStatisticsAlgorithm::shortHelpString() const
50{
51 return QObject::tr( "This algorithm computes basic statistics from the values in a given band of the raster layer." );
52}
53
54QString QgsRasterStatisticsAlgorithm::shortDescription() const
55{
56 return QObject::tr( "Computes basic statistics from the values in a given band of the raster layer." );
57}
58
59QgsRasterStatisticsAlgorithm *QgsRasterStatisticsAlgorithm::createInstance() const
60{
61 return new QgsRasterStatisticsAlgorithm();
62}
63
64void QgsRasterStatisticsAlgorithm::initAlgorithm( const QVariantMap & )
65{
66 addParameter( new QgsProcessingParameterRasterLayer( QStringLiteral( "INPUT" ), QObject::tr( "Input layer" ) ) );
67 addParameter( new QgsProcessingParameterBand( QStringLiteral( "BAND" ), QObject::tr( "Band number" ), 1, QStringLiteral( "INPUT" ) ) );
68
69 addParameter( new QgsProcessingParameterFileDestination( QStringLiteral( "OUTPUT_HTML_FILE" ), QObject::tr( "Statistics" ), QObject::tr( "HTML files (*.html *.HTML)" ), QVariant(), true ) );
70 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "COUNT" ), QObject::tr( "Count of non-NoData pixels" ) ) );
71 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "MIN" ), QObject::tr( "Minimum value" ) ) );
72 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "MAX" ), QObject::tr( "Maximum value" ) ) );
73 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "RANGE" ), QObject::tr( "Range" ) ) );
74 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "SUM" ), QObject::tr( "Sum" ) ) );
75 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "MEAN" ), QObject::tr( "Mean value" ) ) );
76 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "STD_DEV" ), QObject::tr( "Standard deviation" ) ) );
77 addOutput( new QgsProcessingOutputNumber( QStringLiteral( "SUM_OF_SQUARES" ), QObject::tr( "Sum of the squares" ) ) );
78}
79
80QVariantMap QgsRasterStatisticsAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
81{
82 QgsRasterLayer *layer = parameterAsRasterLayer( parameters, QStringLiteral( "INPUT" ), context );
83
84 if ( !layer )
85 throw QgsProcessingException( invalidRasterError( parameters, QStringLiteral( "INPUT" ) ) );
86
87 const int band = parameterAsInt( parameters, QStringLiteral( "BAND" ), context );
88 if ( band < 1 || band > layer->bandCount() )
89 throw QgsProcessingException( QObject::tr( "Invalid band number for BAND (%1): Valid values for input raster are 1 to %2" ).arg( band ).arg( layer->bandCount() ) );
90
91 const QString outputFile = parameterAsFileOutput( parameters, QStringLiteral( "OUTPUT_HTML_FILE" ), context );
92
94
95 QVariantMap outputs;
96 outputs.insert( QStringLiteral( "COUNT" ), stat.elementCount );
97 outputs.insert( QStringLiteral( "MIN" ), stat.minimumValue );
98 outputs.insert( QStringLiteral( "MAX" ), stat.maximumValue );
99 outputs.insert( QStringLiteral( "RANGE" ), stat.range );
100 outputs.insert( QStringLiteral( "SUM" ), stat.sum );
101 outputs.insert( QStringLiteral( "MEAN" ), stat.mean );
102 outputs.insert( QStringLiteral( "STD_DEV" ), stat.stdDev );
103 outputs.insert( QStringLiteral( "SUM_OF_SQUARES" ), stat.sumOfSquares );
104
105 if ( !outputFile.isEmpty() )
106 {
107 QFile file( outputFile );
108 if ( file.open( QIODevice::WriteOnly | QIODevice::Truncate ) )
109 {
110 QTextStream out( &file );
111#if QT_VERSION < QT_VERSION_CHECK( 6, 0, 0 )
112 out.setCodec( "UTF-8" );
113#endif
114 out << QStringLiteral( "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html;charset=utf-8\"/></head><body>\n" );
115 out << QObject::tr( "<p>Analyzed file: %1 (band %2)</p>\n" ).arg( layer->source() ).arg( band );
116 out << QObject::tr( "<p>Count of non-NoData pixels: %1</p>\n" ).arg( stat.elementCount );
117 out << QObject::tr( "<p>Minimum value: %1</p>\n" ).arg( stat.minimumValue, 0, 'g', 16 );
118 out << QObject::tr( "<p>Maximum value: %1</p>\n" ).arg( stat.maximumValue, 0, 'g', 16 );
119 out << QObject::tr( "<p>Range: %1</p>\n" ).arg( stat.range, 0, 'g', 16 );
120 out << QObject::tr( "<p>Sum: %1</p>\n" ).arg( stat.sum, 0, 'g', 16 );
121 out << QObject::tr( "<p>Mean value: %1</p>\n" ).arg( stat.mean, 0, 'g', 16 );
122 out << QObject::tr( "<p>Standard deviation: %1</p>\n" ).arg( stat.stdDev, 0, 'g', 16 );
123 out << QObject::tr( "<p>Sum of the squares: %1</p>\n" ).arg( stat.sumOfSquares, 0, 'g', 16 );
124 out << QStringLiteral( "</body></html>" );
125
126 outputs.insert( QStringLiteral( "OUTPUT_HTML_FILE" ), outputFile );
127 }
128 }
129
130 return outputs;
131}
132
@ All
All available statistics.
Definition qgis.h:5948
QString source() const
Returns the source for the layer.
Contains information about the context in which a processing algorithm is executed.
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
A numeric output for processing algorithms.
A raster band parameter for Processing algorithms.
A generic file based destination parameter, for specifying the destination path for a file (non-map l...
A raster layer parameter for processing algorithms.
The RasterBandStats struct is a container for statistics about a single raster band.
qgssize elementCount
The number of not no data cells in the band.
double sumOfSquares
The sum of the squares. Used to calculate standard deviation.
double mean
The mean cell value for the band. NO_DATA values are excluded.
double stdDev
The standard deviation of the cell values.
double minimumValue
The minimum cell value in the raster band.
double sum
The sum of all cells in the band. NO_DATA values are excluded.
double maximumValue
The maximum cell value in the raster band.
double range
The range is the distance between min & max.
Q_DECL_DEPRECATED QgsRasterBandStats bandStatistics(int bandNo, int stats, const QgsRectangle &extent=QgsRectangle(), int sampleSize=0, QgsRasterBlockFeedback *feedback=nullptr)
Returns the band statistics.
Represents a raster layer.
int bandCount() const
Returns the number of bands in this layer.
QgsRasterDataProvider * dataProvider() override
Returns the source data provider.
A rectangle specified with double values.