QGIS API Documentation 3.99.0-Master (d270888f95f)
Loading...
Searching...
No Matches
qgsclassificationlogarithmic.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsclassificationlogarithmic.h
3 ---------------------
4 begin : September 2019
5 copyright : (C) 2019 by Denis Rouzaud
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
17
18#include "qgsapplication.h"
20#include "qgssymbollayerutils.h"
21
22#include <QObject>
23#include <QString>
24
25using namespace Qt::StringLiterals;
26
29{
30 QgsProcessingParameterEnum *param = new QgsProcessingParameterEnum( u"ZERO_NEG_VALUES_HANDLE"_s, QObject::tr( "Handling of 0 or negative values" ), QStringList() << QObject::tr( "no handling (faster)" ) << QObject::tr( "discard (slower)" ) << QObject::tr( "prepend range (slower)" ), false, 0 );
31 addParameter( param );
32}
33
34
35std::unique_ptr<QgsClassificationMethod> QgsClassificationLogarithmic::clone() const
36{
37 auto c = std::make_unique< QgsClassificationLogarithmic >();
38 copyBase( c.get() );
39 return c;
40}
41
43{
44 return QObject::tr( "Logarithmic Scale" );
45}
46
48{
49 return u"Logarithmic"_s;
50}
51
53{
54 return QgsApplication::getThemeIcon( "classification_methods/mClassificationLogarithmic.svg" );
55}
56
57QList<double> QgsClassificationLogarithmic::calculateBreaks( double &minimum, double &maximum, const QList<double> &values, int nclasses, QString &error )
58{
59 Q_UNUSED( error )
60 const QgsProcessingContext context;
61 const QgsProcessingParameterDefinition *def = parameterDefinition( u"ZERO_NEG_VALUES_HANDLE"_s );
63
64 double positiveMinimum = std::numeric_limits<double>::max();
65 if ( nvh != NegativeValueHandling::NoHandling && minimum <= 0 )
66 {
67 Q_ASSERT( values.count() );
68 if ( maximum > 0 )
69 {
70 for ( int i = 0; i < values.count(); i++ )
71 {
72 if ( values.at( i ) > 0 )
73 positiveMinimum = std::min( positiveMinimum, values.at( i ) );
74 }
75 }
76 if ( positiveMinimum == std::numeric_limits<double>::max() )
77 {
78 // there is no usable values
80 return QList<double>( {0} );
81 else
82 return QList<double>();
83 }
84 }
85
86 QList<double> breaks;
87
88 if ( positiveMinimum != std::numeric_limits<double>::max() )
89 {
91 breaks << std::floor( std::log10( positiveMinimum ) );
92 else if ( nvh == NegativeValueHandling::Discard )
93 minimum = positiveMinimum; // the minimum gets updated
94 }
95 else
96 {
97 positiveMinimum = minimum;
98 }
99
100 // get the min/max in log10 scale
101 const double actualLogMin { std::log10( positiveMinimum ) };
102 double logMin = std::floor( actualLogMin );
103 const double logMax = std::ceil( std::log10( maximum ) );
104
105 // calculate pretty breaks
106 QList<double> prettyBreaks { QgsSymbolLayerUtils::prettyBreaks( logMin, logMax, nclasses ) };
107
108 // If case the first class greater than the actual log min increase the minimum log
109 while ( ! prettyBreaks.isEmpty() && prettyBreaks.first() < actualLogMin )
110 {
111 logMin += 1.0;
112 prettyBreaks = QgsSymbolLayerUtils::prettyBreaks( logMin, logMax, nclasses );
113 }
114
115 breaks.append( prettyBreaks );
116
117 // create the value
118 for ( int i = 0; i < breaks.count(); i++ )
119 {
120 breaks[i] = std::pow( 10, breaks.at( i ) );
121 }
122
123 return breaks;
124}
125
126QString QgsClassificationLogarithmic::valueToLabel( double value ) const
127{
128 if ( value <= 0 )
129 {
130 return QLocale().toString( value );
131 }
132 else
133 {
134 if ( std::isnan( value ) )
135 {
136 return QObject::tr( "invalid (0 or negative values in the data)" );
137 }
138 else
139 {
140 return QString( u"10^%L1"_s ).arg( std::log10( value ) );
141 }
142 }
143}
144
145QString QgsClassificationLogarithmic::labelForRange( double lowerValue, double upperValue, QgsClassificationMethod::ClassPosition position ) const
146{
147 QString lowerLabel;
148 const QString upperLabel = valueToLabel( upperValue );
149
150 switch ( position )
151 {
152 case LowerBound:
153 lowerLabel = formatNumber( lowerValue ); // avoid to have float exponent for the minimum value
154 break;
155 case Inner:
156 case UpperBound:
157 lowerLabel = valueToLabel( lowerValue );
158 break;
159 }
160
161 return labelFormat().arg( lowerLabel, upperLabel );
162}
163
165{
166 const QgsProcessingContext context;
167 const QgsProcessingParameterDefinition *def = parameterDefinition( u"ZERO_NEG_VALUES_HANDLE"_s );
169
171}
static QIcon getThemeIcon(const QString &name, const QColor &fillColor=QColor(), const QColor &strokeColor=QColor())
Helper to get a theme icon.
std::unique_ptr< QgsClassificationMethod > clone() const override
Returns a clone of the method.
bool valuesRequired() const override
Returns if the method requires values to calculate the classes If not, bounds are sufficient.
NegativeValueHandling
Handling of negative and 0 values in the method.
@ PrependBreak
Prepend an extra break to include negative values - this will require all values.
@ Discard
Negative values are discarded - this will require all values.
QString labelForRange(double lowerValue, double upperValue, ClassPosition position) const override
Returns the label for a range.
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.
QIcon icon() const override
The icon of the method.
QVariantMap parameterValues() const
Returns the values of the processing parameters.
ClassPosition
Defines the class position.
@ LowerBound
The class is at the lower bound.
@ UpperBound
The class is at the upper bound.
@ Inner
The class is not at a bound.
void addParameter(QgsProcessingParameterDefinition *definition)
Add a parameter to the method.
QString labelFormat() const
Returns the format of the label for the classes.
QgsClassificationMethod(MethodProperties properties=NoFlag, int codeComplexity=1)
Creates a classification method.
const QgsProcessingParameterDefinition * parameterDefinition(const QString &parameterName) const
Returns the parameter from its name.
QString formatNumber(double value) const
Format the number according to label properties.
void copyBase(QgsClassificationMethod *c) const
Copy the parameters (shall be used in clone implementation).
Contains information about the context in which a processing algorithm is executed.
Base class for the definition of processing parameters.
An enum based parameter for processing algorithms, allowing for selection from predefined values.
static int parameterAsEnum(const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QgsProcessingContext &context)
Evaluates the parameter with matching definition to a enum value.
static QList< double > prettyBreaks(double minimum, double maximum, int classes)
Computes a sequence of about 'classes' equally spaced round values which cover the range of values fr...
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c