33#include "moc_qgsrasterinterface.cpp"
35using namespace Qt::StringLiterals;
48 QgsDebugMsgLevel( u
"theBandNo = %1 sampleSize = %2"_s.arg( bandNo ).arg( sampleSize ), 4 );
62 statistics.
extent = finalExtent;
68 xRes = yRes = std::sqrt( ( finalExtent.
width() * finalExtent.
height() ) / sampleSize );
82 statistics.
width =
static_cast<int>( std::ceil( finalExtent.
width() / xRes ) );
83 statistics.
height =
static_cast<int>( std::ceil( finalExtent.
height() / yRes ) );
94 statistics.
width = 1000;
103 QgsDebugMsgLevel( u
"theBandNo = %1 stats = %2 sampleSize = %3"_s.arg( bandNo ).arg(
static_cast<int>( stats ) ).arg( sampleSize ), 4 );
113 if ( stats.contains( myRasterBandStats ) )
124 QgsDebugMsgLevel( u
"theBandNo = %1 stats = %2 sampleSize = %3"_s.arg( bandNo ).arg(
static_cast<int>( stats ) ).arg( sampleSize ), 4 );
134 if ( stats.contains( myRasterBandStats ) )
142 const int myWidth = myRasterBandStats.
width;
143 const int myHeight = myRasterBandStats.
height;
149 if ( myXBlockSize == 0 )
153 if ( myYBlockSize == 0 )
158 const int myNXBlocks = ( myWidth + myXBlockSize - 1 ) / myXBlockSize;
159 const int myNYBlocks = ( myHeight + myYBlockSize - 1 ) / myYBlockSize;
161 const double myXRes = myExtent.
width() / myWidth;
162 const double myYRes = myExtent.
height() / myHeight;
167 double mySumOfSquares = 0;
169 bool myFirstIterationFlag =
true;
170 bool isNoData =
false;
171 for (
int myYBlock = 0; myYBlock < myNYBlocks; myYBlock++ )
173 for (
int myXBlock = 0; myXBlock < myNXBlocks; myXBlock++ )
176 return myRasterBandStats;
178 QgsDebugMsgLevel( u
"myYBlock = %1 myXBlock = %2"_s.arg( myYBlock ).arg( myXBlock ), 4 );
179 const int myBlockWidth = std::min( myXBlockSize, myWidth - myXBlock * myXBlockSize );
180 const int myBlockHeight = std::min( myYBlockSize, myHeight - myYBlock * myYBlockSize );
182 const double xmin = myExtent.
xMinimum() + myXBlock * myXBlockSize * myXRes;
183 const double xmax = xmin + myBlockWidth * myXRes;
184 const double ymin = myExtent.
yMaximum() - myYBlock * myYBlockSize * myYRes;
185 const double ymax = ymin - myBlockHeight * myYRes;
187 const QgsRectangle myPartExtent( xmin, ymin, xmax, ymax );
189 std::unique_ptr< QgsRasterBlock > blk(
block( bandNo, myPartExtent, myBlockWidth, myBlockHeight, feedback ) );
192 for (
qgssize i = 0; i < ( static_cast< qgssize >( myBlockHeight ) ) * myBlockWidth; i++ )
194 const double myValue = blk->valueAndNoData( i, isNoData );
198 myRasterBandStats.
sum += myValue;
201 if ( !std::isfinite( myValue ) )
204 if ( myFirstIterationFlag )
206 myFirstIterationFlag =
false;
223 const double myDelta = myValue - myMean;
225 mySumOfSquares += myDelta * ( myValue - myMean );
238 myRasterBandStats.
stdDev = std::sqrt( mySumOfSquares / (
static_cast< double >( myRasterBandStats.
elementCount ) - 1 ) );
250 return myRasterBandStats;
263 histogram.includeOutOfRange = includeOutOfRange;
308 if ( sampleSize > 0 )
312 xRes = yRes = std::sqrt( (
static_cast<double>( finalExtent.
width() ) * finalExtent.
height() ) / sampleSize );
319 if ( xRes < srcXRes )
321 if ( yRes < srcYRes )
344 qint64 myBinCount = binCount;
345 if ( myBinCount == 0 )
377 constexpr double SCOTTS_COEFFICIENT = 42.538892421732385;
378 myBinCount =
static_cast<qint64
>( stats.
range / ( stats.
stdDev * std::cbrt( SCOTTS_COEFFICIENT / ( sampleSize > 0 ? sampleSize :
static_cast<double>(
histogram.width ) *
histogram.height ) ) ) );
383 myBinCount =
static_cast<qint64
>(
histogram.width ) *
static_cast<qint64
>(
histogram.height );
389 histogram.binCount =
static_cast<int>( std::min( 10000000LL, myBinCount ) );
400 QgsDebugMsgLevel( u
"theBandNo = %1 binCount = %2 minimum = %3 maximum = %4 sampleSize = %5"_s.arg( bandNo ).arg( binCount ).arg( minimum ).arg( maximum ).arg( sampleSize ), 4 );
407 initHistogram( myHistogram, bandNo, binCount, minimum, maximum,
extent, sampleSize, includeOutOfRange );
423 QgsDebugMsgLevel( u
"theBandNo = %1 binCount = %2 minimum = %3 maximum = %4 sampleSize = %5"_s.arg( bandNo ).arg( binCount ).arg( minimum ).arg( maximum ).arg( sampleSize ), 4 );
426 initHistogram( myHistogram, bandNo, binCount, minimum, maximum,
extent, sampleSize, includeOutOfRange );
439 const int myBinCount = myHistogram.
binCount;
440 const int myWidth = myHistogram.
width;
441 const int myHeight = myHistogram.
height;
447 if ( myXBlockSize == 0 )
451 if ( myYBlockSize == 0 )
456 const int myNXBlocks = ( myWidth + myXBlockSize - 1 ) / myXBlockSize;
457 const int myNYBlocks = ( myHeight + myYBlockSize - 1 ) / myYBlockSize;
459 const double myXRes = myExtent.
width() / myWidth;
460 const double myYRes = myExtent.
height() / myHeight;
462 double myMinimum = myHistogram.
minimum;
463 double myMaximum = myHistogram.
maximum;
467 const double myerval = ( myMaximum - myMinimum ) / myHistogram.
binCount;
468 myMinimum -= 0.1 * myerval;
469 myMaximum += 0.1 * myerval;
471 QgsDebugMsgLevel( u
"binCount = %1 myMinimum = %2 myMaximum = %3"_s.arg( myHistogram.
binCount ).arg( myMinimum ).arg( myMaximum ), 4 );
473 const double myBinSize = ( myMaximum - myMinimum ) / myBinCount;
476 bool isNoData =
false;
477 for (
int myYBlock = 0; myYBlock < myNYBlocks; myYBlock++ )
479 for (
int myXBlock = 0; myXBlock < myNXBlocks; myXBlock++ )
484 const int myBlockWidth = std::min( myXBlockSize, myWidth - myXBlock * myXBlockSize );
485 const int myBlockHeight = std::min( myYBlockSize, myHeight - myYBlock * myYBlockSize );
487 const double xmin = myExtent.
xMinimum() + myXBlock * myXBlockSize * myXRes;
488 const double xmax = xmin + myBlockWidth * myXRes;
489 const double ymin = myExtent.
yMaximum() - myYBlock * myYBlockSize * myYRes;
490 const double ymax = ymin - myBlockHeight * myYRes;
492 const QgsRectangle myPartExtent( xmin, ymin, xmax, ymax );
494 std::unique_ptr< QgsRasterBlock > blk(
block( bandNo, myPartExtent, myBlockWidth, myBlockHeight, feedback ) );
497 for (
qgssize i = 0; i < ( static_cast< qgssize >( myBlockHeight ) ) * myBlockWidth; i++ )
499 const double myValue = blk->valueAndNoData( i, isNoData );
505 int myBinIndex =
static_cast<int>( std::floor( ( myValue - myMinimum ) / myBinSize ) );
507 if ( ( myBinIndex < 0 || myBinIndex > ( myBinCount - 1 ) ) && !includeOutOfRange )
511 if ( myBinIndex < 0 )
513 if ( myBinIndex > ( myBinCount - 1 ) )
514 myBinIndex = myBinCount - 1;
522 myHistogram.
valid =
true;
527 for ( std::size_t i = 0; i < std::min< std::size_t >( myHistogram.
histogramVector.size(), 500 ); i++ )
529 hist += QString::number( myHistogram.
histogramVector.value( i ) ) +
' ';
539 QgsDebugMsgLevel( u
"theBandNo = %1 lowerCount = %2 upperCount = %3 sampleSize = %4"_s.arg( bandNo ).arg( lowerCount ).arg( upperCount ).arg( sampleSize ), 4 );
544 lowerValue = std::numeric_limits<double>::quiet_NaN();
545 upperValue = std::numeric_limits<double>::quiet_NaN();
559 const int myMinCount =
static_cast< int >( std::round( lowerCount * myHistogram.
nonNullCount ) );
560 const int myMaxCount =
static_cast< int >( std::round( upperCount * myHistogram.
nonNullCount ) );
561 bool myLowerFound =
false;
563 QgsDebugMsgLevel( u
"myMinCount = %1 myMaxCount = %2"_s.arg( myMinCount ).arg( myMaxCount ), 4 );
565 for (
int myBin = 0; myBin < myHistogram.
histogramVector.size(); myBin++ )
568 myCount += myBinValue;
569 if ( !myLowerFound && myCount > myMinCount )
571 lowerValue = myHistogram.
minimum + myBin * myBinXStep;
573 QgsDebugMsgLevel( u
"found lowerValue %1 at bin %2"_s.arg( lowerValue ).arg( myBin ), 4 );
575 if ( myCount >= myMaxCount )
577 upperValue = myHistogram.
minimum + myBin * myBinXStep;
578 QgsDebugMsgLevel( u
"found upperValue %1 at bin %2"_s.arg( upperValue ).arg( myBin ), 4 );
590 if ( !std::isnan( lowerValue ) )
591 lowerValue = std::floor( lowerValue );
592 if ( !std::isnan( upperValue ) )
593 upperValue = std::ceil( upperValue );
599 QStringList abilitiesList;
609 abilitiesList += tr(
"Identify" );
614 abilitiesList += tr(
"Build Pyramids" );
619 return abilitiesList.join(
", "_L1 );
625 return mInput->generateBandName( bandNumber );
628 return tr(
"Band" ) + u
" %1"_s.arg( bandNumber, 1 + (
bandCount() > 0 ?
static_cast< int >( std::log10(
static_cast< double >(
bandCount() ) ) ) : 0 ), 10, QChar(
'0' ) );
634 return mInput->colorInterpretationName( bandNo );
643 if ( colorInterp != tr(
"Undefined" ) )
645 name.append( u
" (%1)"_s.arg( colorInterp ) );
657 return mRenderContext;
QFlags< RasterInterfaceCapability > RasterInterfaceCapabilities
Raster interface capabilities.
@ BuildPyramids
Supports building of pyramids (overviews) (Deprecated since QGIS 3.38 – use RasterProviderCapability:...
@ NoCapabilities
No capabilities.
@ Size
Original data source size (and thus resolution) is known, it is not always available,...
@ Identify
At least one identify format supported.
QFlags< RasterBandStatistic > RasterBandStatistics
Statistics to be calculated for raster bands.
@ StdDev
Standard deviation.
@ All
All available statistics.
DataType
Raster data types.
@ Int16
Sixteen bit signed integer (qint16).
@ UInt16
Sixteen bit unsigned integer (quint16).
@ Byte
Eight bit unsigned integer (quint8).
@ Int32
Thirty two bit signed integer (qint32).
@ UInt32
Thirty two bit unsigned integer (quint32).
bool isCanceled() const
Tells whether the operation has been canceled already.
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.
int bandNumber
The gdal band number (starts at 1).
double sumOfSquares
The sum of the squares. Used to calculate standard deviation.
int height
Number of rows used to calc statistics.
double mean
The mean cell value for the band. NO_DATA values are excluded.
QgsRectangle extent
Extent used to calc statistics.
double stdDev
The standard deviation of the cell values.
double minimumValue
The minimum cell value in the raster band.
int width
Number of columns used to calc statistics.
double sum
The sum of all cells in the band. NO_DATA values are excluded.
Qgis::RasterBandStatistics statsGathered
Collected statistics.
double maximumValue
The maximum cell value in the raster band.
double range
The range is the distance between min & max.
Feedback object tailored for raster block reading.
QgsRenderContext renderContext() const
Returns the render context of the associated block reading.
void setRenderContext(const QgsRenderContext &renderContext)
Sets the render context of the associated block reading.
A container for a histogram of a single raster band.
double minimum
The minimum histogram value.
double maximum
The maximum histogram value.
QgsRectangle extent
Extent used to calc histogram.
int nonNullCount
The number of non NULL cells used to calculate histogram.
QgsRasterHistogram::HistogramVector histogramVector
Stores the histogram for a given layer.
int height
Number of rows used to calc histogram.
int width
Number of columns used to calc histogram.
bool valid
Histogram is valid.
int binCount
Number of bins (intervals,buckets) in histogram.
virtual void cumulativeCut(int bandNo, double lowerCount, double upperCount, double &lowerValue, double &upperValue, const QgsRectangle &extent=QgsRectangle(), int sampleSize=0)
Find values for cumulative pixel count cut.
virtual Qgis::RasterInterfaceCapabilities capabilities() const
Returns the capabilities supported by the interface.
virtual int yBlockSize() const
virtual QgsRasterBlock * block(int bandNo, const QgsRectangle &extent, int width, int height, QgsRasterBlockFeedback *feedback=nullptr)=0
Read block of data using given extent and size.
Q_DECL_DEPRECATED void initStatistics(QgsRasterBandStats &statistics, int bandNo, int stats, const QgsRectangle &boundingBox=QgsRectangle(), int binCount=0) const
Fill in statistics defaults if not specified.
QList< QgsRasterBandStats > mStatistics
List of cached statistics, all bands mixed.
Q_DECL_DEPRECATED QString capabilitiesString() const
Returns the raster interface capabilities in friendly format.
void initHistogram(QgsRasterHistogram &histogram, int bandNo, int binCount, double minimum=std::numeric_limits< double >::quiet_NaN(), double maximum=std::numeric_limits< double >::quiet_NaN(), const QgsRectangle &boundingBox=QgsRectangle(), int sampleSize=0, bool includeOutOfRange=false)
Fill in histogram defaults if not specified.
virtual int xSize() const
Gets raster size.
virtual QString generateBandName(int bandNumber) const
helper function to create zero padded band names
QgsRasterInterface(QgsRasterInterface *input=nullptr)
Q_DECL_DEPRECATED QgsRasterBandStats bandStatistics(int bandNo, int stats, const QgsRectangle &extent=QgsRectangle(), int sampleSize=0, QgsRasterBlockFeedback *feedback=nullptr)
Returns the band statistics.
virtual Qgis::DataType sourceDataType(int bandNo) const
Returns source data type for the band specified by number, source data type may be shorter than dataT...
virtual int xBlockSize() const
Gets block size.
virtual int bandCount() const =0
Gets number of bands.
virtual bool hasHistogram(int bandNo, int binCount, double minimum=std::numeric_limits< double >::quiet_NaN(), double maximum=std::numeric_limits< double >::quiet_NaN(), const QgsRectangle &extent=QgsRectangle(), int sampleSize=0, bool includeOutOfRange=false)
Returns true if histogram is available (cached, already calculated).
QString displayBandName(int bandNumber) const
Generates a friendly, descriptive name for the specified bandNumber.
Q_DECL_DEPRECATED bool hasStatistics(int bandNo, int stats, const QgsRectangle &extent=QgsRectangle(), int sampleSize=0)
Returns true if histogram is available (cached, already calculated).
QgsRasterInterface * mInput
virtual int ySize() const
virtual QgsRectangle extent() const
Gets the extent of the interface.
QList< QgsRasterHistogram > mHistograms
List of cached histograms, all bands mixed.
virtual QString colorInterpretationName(int bandNumber) const
Returns the name of the color interpretation for the specified bandNumber.
virtual QgsRasterInterface * input() const
Current input.
virtual QgsRasterHistogram histogram(int bandNo, int binCount=0, double minimum=std::numeric_limits< double >::quiet_NaN(), double maximum=std::numeric_limits< double >::quiet_NaN(), const QgsRectangle &extent=QgsRectangle(), int sampleSize=0, bool includeOutOfRange=false, QgsRasterBlockFeedback *feedback=nullptr)
Returns a band histogram.
A rectangle specified with double values.
QgsRectangle intersect(const QgsRectangle &rect) const
Returns the intersection with the given rectangle.
Contains information about the context of a rendering operation.
unsigned long long qgssize
Qgssize is used instead of size_t, because size_t is stdlib type, unknown by SIP, and it would be har...
#define QgsDebugMsgLevel(str, level)