mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
5c42c7636b
in property assistant Makes it easier to set suitable curves. Populated in the background for a nice reponsive widget!
61 lines
1.9 KiB
Plaintext
61 lines
1.9 KiB
Plaintext
/** \ingroup core
|
|
* \class QgsHistogram
|
|
* \brief Calculator for a numeric histogram from a list of values.
|
|
*
|
|
* \note Added in version 2.9
|
|
*/
|
|
|
|
class QgsHistogram
|
|
{
|
|
%TypeHeaderCode
|
|
#include "qgshistogram.h"
|
|
%End
|
|
|
|
public:
|
|
|
|
QgsHistogram();
|
|
|
|
virtual ~QgsHistogram();
|
|
|
|
/** Assigns numeric source values for the histogram.
|
|
* @param values list of doubles
|
|
*/
|
|
void setValues( const QList<double>& values );
|
|
|
|
bool setValues( const QgsVectorLayer* layer, const QString& fieldOrExpression, QgsFeedback* feedback = 0 );
|
|
|
|
/** Calculates the optimal bin width using the Freedman-Diaconis rule. Bins widths are
|
|
* determined by the inter-quartile range of values and the number of values.
|
|
* @returns optimal width for bins
|
|
* @see optimalNumberBins
|
|
* @note values must first be specified using @link setValues @endlink
|
|
*/
|
|
double optimalBinWidth() const;
|
|
|
|
/** Returns the optimal number of bins for the source values, calculated using the
|
|
* Freedman-Diaconis rule. The number of bins are determined by the inter-quartile range
|
|
* of values and the number of values.
|
|
* @returns optimal number of bins
|
|
* @see optimalBinWidth
|
|
* @note values must first be specified using @link setValues @endlink
|
|
*/
|
|
int optimalNumberBins() const;
|
|
|
|
/** Returns a list of edges for the histogram for a specified number of bins. This list
|
|
* will be length bins + 1, as both the first and last value are also included.
|
|
* @param bins number of bins
|
|
* @return list of bin edges
|
|
* @note values must first be specified using @link setValues @endlink
|
|
*/
|
|
QList<double> binEdges( int bins ) const;
|
|
|
|
/** Returns the calculated list of the counts for the histogram bins.
|
|
* @param bins number of histogram bins
|
|
* @return list of histogram counts
|
|
* @note values must first be specified using @link setValues @endlink
|
|
*/
|
|
QList<int> counts( int bins ) const;
|
|
|
|
};
|
|
|