QgsHistogram Class Reference

Calculator for a numeric histogram from a list of values. More...

#include <qgshistogram.h>

Public Member Functions
	QgsHistogram ()=default
virtual	~QgsHistogram ()=default
QList< double >	binEdges (int bins) const
	Returns a list of edges for the histogram for a specified number of bins.
QList< int >	counts (int bins) const
	Returns the calculated list of the counts for the histogram bins.
double	optimalBinWidth () const
	Calculates the optimal bin width using the Freedman-Diaconis rule.
int	optimalNumberBins () const
	Returns the optimal number of bins for the source values, calculated using the Freedman-Diaconis rule.
bool	setValues (const QgsVectorLayer *layer, const QString &fieldOrExpression, QgsFeedback *feedback=nullptr)
	Assigns numeric source values for the histogram from a vector layer's field or as the result of an expression.
void	setValues (const QList< double > &values)
	Assigns numeric source values for the histogram.

Detailed Description

Calculator for a numeric histogram from a list of values.

Definition at line 36 of file qgshistogram.h.

Constructor & Destructor Documentation

QgsHistogram()

QgsHistogram::QgsHistogram ( )

default

~QgsHistogram()

virtual QgsHistogram::~QgsHistogram ( )

virtualdefault

Member Function Documentation

binEdges()

QList< double > QgsHistogram::binEdges

(

int

bins

)

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.

Parameters

bins	number of bins

Returns

list of bin edges

Note

values must first be specified using setValues()

Definition at line 68 of file qgshistogram.cpp.

counts()

QList< int > QgsHistogram::counts

(

int

bins

)

const

Returns the calculated list of the counts for the histogram bins.

Parameters

bins	number of histogram bins

Returns

list of histogram counts

Note

values must first be specified using setValues()

Definition at line 84 of file qgshistogram.cpp.

optimalBinWidth()

double QgsHistogram::optimalBinWidth

(

)

const

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 also

optimalNumberBins

Note

values must first be specified using setValues()

Definition at line 57 of file qgshistogram.cpp.

optimalNumberBins()

int QgsHistogram::optimalNumberBins

(

)

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 also

optimalBinWidth

Note

values must first be specified using setValues()

Definition at line 63 of file qgshistogram.cpp.

setValues() [1/2]

bool QgsHistogram::setValues	(	const QgsVectorLayer *	layer,
		const QString &	fieldOrExpression,
		QgsFeedback *	feedback = nullptr
	)

Assigns numeric source values for the histogram from a vector layer's field or as the result of an expression.

Parameters

layer	vector layer
fieldOrExpression	field name or expression to be evaluated
feedback	optional feedback object to allow cancellation of calculation

Returns

true if values were successfully set

Definition at line 42 of file qgshistogram.cpp.

setValues() [2/2]

void QgsHistogram::setValues

(

const QList< double > &

values

)

Assigns numeric source values for the histogram.

Parameters

values

list of doubles

Definition at line 36 of file qgshistogram.cpp.

---

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

• /build/qgis-3.41.0+git20241126+3291e9ff48b+99sid/src/core/qgshistogram.h
• /build/qgis-3.41.0+git20241126+3291e9ff48b+99sid/src/core/qgshistogram.cpp