QgsClassificationJenks is an implementation of QgsClassificationMethod for natural breaks based on Jenks method. More...

#include <qgsclassificationjenks.h>

Inheritance diagram for QgsClassificationJenks:

[legend]

Public Member Functions
	QgsClassificationJenks ()

std::unique_ptr< QgsClassificationMethod >	clone () const override
	Returns a clone of the method.

QIcon	icon () const override
	The icon of the method.

QString	id () const override
	The id of the method as saved in the project, must be unique in registry.

QString	name () const override
	The readable and translate name of the method.

Public Member Functions inherited from QgsClassificationMethod
	QgsClassificationMethod (MethodProperties properties=NoFlag, int codeComplexity=1)
	Creates a classification method.

virtual	~QgsClassificationMethod ()

Q_DECL_DEPRECATED QList< QgsClassificationRange >	classes (const QgsVectorLayer *layer, const QString &expression, int nclasses)
	This will calculate the classes for a given layer to define the classes.

QList< QgsClassificationRange >	classes (const QList< double > &values, int nclasses)
	This will calculate the classes for a list of values.

QList< QgsClassificationRange >	classes (double minimum, double maximum, int nclasses)
	This will calculate the classes for defined bounds without any values.

QList< QgsClassificationRange >	classesV2 (const QgsVectorLayer *layer, const QString &expression, int nclasses, QString &error)
	This will calculate the classes for a given layer to define the classes.

int	codeComplexity () const
	Code complexity as the exponent in Big O notation.

QgsClassificationMethod::MethodProperties	flags () const
	Returns the classification flags.

QString	labelFormat () const
	Returns the format of the label for the classes.

QString	labelForRange (const QgsRendererRange &range, ClassPosition position=Inner) const
	Returns the label for a range.

virtual QString	labelForRange (double lowerValue, double upperValue, ClassPosition position=Inner) const
	Returns the label for a range.

int	labelPrecision () const
	Returns the precision for the formatting of the labels.

bool	labelTrimTrailingZeroes () const
	Returns if the trailing 0 are trimmed in the label.

const QgsProcessingParameterDefinition *	parameterDefinition (const QString &parameterName) const
	Returns the parameter from its name.

QgsProcessingParameterDefinitions	parameterDefinitions () const
	Returns the list of parameters.

QVariantMap	parameterValues () const
	Returns the values of the processing parameters.

virtual void	readXml (const QDomElement &element, const QgsReadWriteContext &context)
	Reads extra information to apply it to the method.

QDomElement	save (QDomDocument &doc, const QgsReadWriteContext &context) const
	Saves the method to a DOM element and return it.

void	setLabelFormat (const QString &format)
	Defines the format of the labels for the classes, using %1 and %2 for the bounds.

void	setLabelPrecision (int labelPrecision)
	Defines the precision for the formatting of the labels.

void	setLabelTrimTrailingZeroes (bool trimTrailingZeroes)
	Defines if the trailing 0 are trimmed in the label.

void	setParameterValues (const QVariantMap &values)
	Defines the values of the additional parameters.

void	setSymmetricMode (bool enabled, double symmetryPoint=0, bool symmetryAstride=false)
	Defines if the symmetric mode is enables and configures its parameters.

bool	symmetricModeAvailable () const
	Returns if the method supports symmetric calculation.

bool	symmetricModeEnabled () const
	Returns if the symmetric mode is enabled.

bool	symmetryAstride () const
	Returns if the symmetric mode is astride if `true`, it will remove the symmetry point break so that the 2 classes form only one.

double	symmetryPoint () const
	Returns the symmetry point for symmetric mode.

virtual bool	valuesRequired () const
	Returns if the method requires values to calculate the classes If not, bounds are sufficient.

virtual void	writeXml (QDomElement &element, const QgsReadWriteContext &context) const
	Writes extra information about the method.

Additional Inherited Members
Public Types inherited from QgsClassificationMethod
enum	ClassPosition { LowerBound , Inner , UpperBound }
	Defines the class position. More...

typedef QFlags< MethodProperty >	MethodProperties

enum	MethodProperty { NoFlag = 0 , ValuesNotRequired = 1 << 1 , SymmetricModeAvailable = 1 << 2 , IgnoresClassCount = 1 << 3 }
	Flags for the classification method. More...

Static Public Member Functions inherited from QgsClassificationMethod
static std::unique_ptr< QgsClassificationMethod >	create (const QDomElement &element, const QgsReadWriteContext &context)
	Reads the DOM element and return a new classification method from it.

static void	makeBreaksSymmetric (QList< double > &breaks, double symmetryPoint, bool astride)
	Remove the breaks that are above the existing opposite sign classes to keep colors symmetrically balanced around symmetryPoint Does not put a break on the symmetryPoint.

static QList< double >	rangesToBreaks (const QList< QgsClassificationRange > &classes)
	Transforms a list of classes to a list of breaks.

Static Public Attributes inherited from QgsClassificationMethod
static const int	MAX_PRECISION = 15

static const int	MIN_PRECISION = -6

Protected Member Functions inherited from QgsClassificationMethod
void	addParameter (QgsProcessingParameterDefinition *definition)
	Add a parameter to the method.

void	copyBase (QgsClassificationMethod *c) const
	Copy the parameters (shall be used in clone implementation)

QString	formatNumber (double value) const
	Format the number according to label properties.

Detailed Description

QgsClassificationJenks is an implementation of QgsClassificationMethod for natural breaks based on Jenks method.

Since: QGIS 3.10

Definition at line 28 of file qgsclassificationjenks.h.

Constructor & Destructor Documentation

◆ QgsClassificationJenks()

QgsClassificationJenks::QgsClassificationJenks ( )

Definition at line 22 of file qgsclassificationjenks.cpp.

Member Function Documentation

◆ clone()

std::unique_ptr< QgsClassificationMethod > QgsClassificationJenks::clone ( ) const

overridevirtual

Returns a clone of the method.

Implementation can take advantage of copyBase method which copies the parameters of the base class

Implements QgsClassificationMethod.

Definition at line 38 of file qgsclassificationjenks.cpp.

◆ icon()

QIcon QgsClassificationJenks::icon ( ) const

overridevirtual

The icon of the method.

Reimplemented from QgsClassificationMethod.

Definition at line 45 of file qgsclassificationjenks.cpp.

◆ id()

QString QgsClassificationJenks::id ( ) const

overridevirtual

The id of the method as saved in the project, must be unique in registry.

Implements QgsClassificationMethod.

Definition at line 33 of file qgsclassificationjenks.cpp.

◆ name()

QString QgsClassificationJenks::name ( ) const

overridevirtual

The readable and translate name of the method.

Implements QgsClassificationMethod.

Definition at line 28 of file qgsclassificationjenks.cpp.

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

/build/qgis-3.41.0+git20241225+af5edcb665c+99sid/src/core/classification/qgsclassificationjenks.h
/build/qgis-3.41.0+git20241225+af5edcb665c+99sid/src/core/classification/qgsclassificationjenks.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsClassificationJenks()

Member Function Documentation

◆ clone()

◆ icon()

◆ id()

◆ name()