cprecolldensityest.h

//==========================================================================
//  CPRECOLLDENSITYEST.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
//==========================================================================

/*--------------------------------------------------------------*
  Copyright (C) 1992-2017 Andras Varga
  Copyright (C) 2006-2017 OpenSim Ltd.

  This file is distributed WITHOUT ANY WARRANTY. See the file
  `license' for details on this and other legal matters.
*--------------------------------------------------------------*/

#ifndef __OMNETPP_CPRECOLLDENSITYEST_H
#define __OMNETPP_CPRECOLLDENSITYEST_H

#include "cabstracthistogram.h"

namespace omnetpp {

class SIM_API cPrecollectionBasedDensityEst : public cAbstractHistogram
{
  public:
    enum RangeMode {
        RANGE_AUTO,      // automatic range setup, using precollected values and range extension (the default)
        RANGE_AUTOLOWER, // like RANGE_AUTO, but upper limit is fixed
        RANGE_AUTOUPPER, // like RANGE_AUTO, but lower limit is fixed
        RANGE_FIXED,     // fixed range (lower, upper)
        RANGE_NOTSET     // not set, but it is OK (cVarHistogram only)
    };

  protected:
    // we can precollect observations to automatically determine the range before histogram bins are set up
    bool transformed;   // whether precollected values have been transformed into a histogram
    double *precollectedValues;
    double *precollectedWeights; // nullptr for unweighted
    int numPrecollected;

    // range for distribution density collection
    RangeMode rangeMode;
    double rangeExtFactor;    // we extend the range of precollected values by rangeExtFactor
    double rangeMin, rangeMax;

    // variables for counting out-of-range observations
    int64_t numUnderflows;
    int64_t numOverflows;
    double underflowSumWeights;
    double overflowSumWeights;

  private:
    void copy(const cPrecollectionBasedDensityEst& other);

  protected:
    static void plotline (std::ostream& os, const char *pref, double xval, double count, double a);

    // part of merge(); to be implemented in subclasses
    virtual void doMergeBinValues(const cPrecollectionBasedDensityEst *other) = 0;

  public:

    cPrecollectionBasedDensityEst(const cPrecollectionBasedDensityEst& other) : cAbstractHistogram(other) {precollectedValues=nullptr; precollectedWeights=nullptr; copy(other);}

    explicit cPrecollectionBasedDensityEst(const char *name=nullptr, bool weighted=false);

    virtual ~cPrecollectionBasedDensityEst();

    cPrecollectionBasedDensityEst& operator=(const cPrecollectionBasedDensityEst& res);


    /* No dup() because this is an abstract class. */

    virtual void parsimPack(cCommBuffer *buffer) const override;

    virtual void parsimUnpack(cCommBuffer *buffer) override;


    virtual void collect(double value) override;
    using cStatistic::collect;

    virtual void collectWeighted(double value, double weight) override;
    using cStatistic::collectWeighted;

    virtual void merge(const cStatistic *other) override;

    virtual void clear() override;

    virtual void saveToFile(FILE *) const override;

    virtual void loadFromFile(FILE *) override;


    virtual void setRange(double lower, double upper);

    virtual void setRangeAuto(int numPrecollect=100, double rangeExtensionFactor=2.0);

    virtual void setRangeAutoLower(double upper, int numPrecollect=100, double rangeExtensionFactor=2.0);

    virtual void setRangeAutoUpper(double lower, int numPrecollect=100, double rangeExtensionFactor=2.0);

    virtual void setNumPrecollectedValues(int numPrecollect);

    virtual int getNumPrecollectedValues() const {return numPrecollected;}

    virtual double getRangeExtensionFactor() const {return rangeExtFactor;}

  protected:
    virtual void setupRange();

    virtual void collectIntoHistogram(double value) = 0;

    virtual void collectWeightedIntoHistogram(double value, double weight) = 0;

  public:
    virtual bool binsAlreadySetUp() const override {return transformed;}

    virtual int64_t getNumUnderflows() const override {return numUnderflows;}

    virtual int64_t getNumOverflows() const override {return numOverflows;}

    virtual double getUnderflowSumWeights() const override {return underflowSumWeights;}

    virtual double getOverflowSumWeights() const override {return overflowSumWeights;}
};

}  // namespace omnetpp


#endif