intervalbinner.h

Go to the documentation of this file.

 
#ifndef OPENSWMM_RENDER_INTERVALBINNER_H
#define OPENSWMM_RENDER_INTERVALBINNER_H
 
#include <QJsonObject>
#include <QVector>
 
namespace OpenSWMM::Render
{
 
enum class BinMethod : int
{
    EqualInterval = 0,  
    Quantile      = 1,  
    Manual        = 2,  
    // VS.3 — additional standard classification methods. Each still yields
    // exactly (binCount-1) interior breaks so the GraduatedRenderer / legend
    // contract is unchanged.
    NaturalBreaks = 3,  
    StdDev        = 4,  
    Logarithmic   = 5,  
    Exponential   = 6,  
};
 
class IntervalBinner
{
public:
    IntervalBinner() = default;
 
    [[nodiscard]] BinMethod      method() const { return m_method; }
    void                         setMethod(BinMethod m) { m_method = m; }
 
    [[nodiscard]] int            binCount() const { return m_nBins; }
    void                         setBinCount(int n) { m_nBins = (n < 1) ? 1 : n; }
 
    [[nodiscard]] const QVector<double> &manualBreaks() const { return m_manualBreaks; }
    void                                 setManualBreaks(QVector<double> breaks);
 
    [[nodiscard]] QVector<double> computeBreaks(const QVector<double> &samples) const;
 
    [[nodiscard]] int binFor(double value, const QVector<double> &breaks) const;
 
    [[nodiscard]] QJsonObject toJson() const;
    static IntervalBinner     fromJson(const QJsonObject &j);
 
private:
    BinMethod        m_method = BinMethod::EqualInterval;
    int              m_nBins  = 5;
    QVector<double>  m_manualBreaks;
};
 
} // namespace OpenSWMM::Render
 
#endif // OPENSWMM_RENDER_INTERVALBINNER_H