BaseLib::Histogram< T > Class Template Reference

Detailed Description

template<typename T>
class BaseLib::Histogram< T >

Basic Histogram implementation.

Creates histogram from input data of type T.

Definition at line 30 of file Histogram.h.

#include <Histogram.h>

Public Types
using	Data

Public Member Functions
template<typename InputIterator>
	Histogram (InputIterator first, InputIterator last, const int nr_bins=16, const bool computeHistogram=true)
	Underlying input data vector type.
	Histogram (std::vector< T > data, const unsigned int nr_bins=16, const bool computeHistogram=true)
void	update ()
void	setMinimum (const T &minimum)
void	setMaximum (const T &maximum)
const Data &	getSortedData () const
const std::vector< std::size_t > &	getBinCounts () const
const unsigned int &	getNumberOfBins () const
const T &	getMinimum () const
const T &	getMaximum () const
const T &	getBinWidth () const
void	prettyPrint (std::ostream &os, const unsigned int line_width=16) const
int	write (std::string const &file_name, std::string const &data_set_name, std::string const &param_name) const

Protected Member Functions
void	init (const bool computeHistogram=true)

Protected Attributes
Data	data_
const unsigned int	nr_bins_
std::vector< std::size_t >	histogram_
T	min_
T	max_
	Minimum and maximum input data values.
T	bin_width_

Private Attributes
bool	dirty_
	When set update() will recompute histogram.

Member Typedef Documentation

Data

template<typename T>

using BaseLib::Histogram< T >::Data

Initial value:

 
        typename std::vector<double>

Definition at line 33 of file Histogram.h.

Constructor & Destructor Documentation

Histogram() [1/2]

template<typename T>

template<typename InputIterator>

BaseLib::Histogram< T >::Histogram ( InputIterator first, InputIterator last, const int nr_bins = 16, const bool computeHistogram = true )

inline

Underlying input data vector type.

Creates histogram of the given element in the range [first, last).

Input data is copied into std::vector.

Parameters

first	Range of elements to create histogram from.
last	Range of elements to create histogram from.
nr_bins	Number of bins in histogram.
computeHistogram	Compute histogram if set. If not set user must call update() before accessing data.

Definition at line 48 of file Histogram.h.

        : data_(first, last), nr_bins_(nr_bins), dirty_(true)
    {
        init(computeHistogram);
    }

References data_, dirty_, init(), and nr_bins_.

Histogram() [2/2]

template<typename T>

BaseLib::Histogram< T >::Histogram ( std::vector< T > data, const unsigned int nr_bins = 16, const bool computeHistogram = true )

inlineexplicit

Creates histogram from std::vector.

Parameters

data	Input vector.
nr_bins	Number of bins in histogram.
computeHistogram	Compute histogram if set. If not set user must call update() before accessing data.

Definition at line 61 of file Histogram.h.

        : data_(std::move(data)), nr_bins_(nr_bins), dirty_(true)
    {
        init(computeHistogram);
    }

References data_, dirty_, init(), and nr_bins_.

Member Function Documentation

getBinCounts()

template<typename T>

const std::vector< std::size_t > & BaseLib::Histogram< T >::getBinCounts ( ) const

inline

Definition at line 110 of file Histogram.h.

{ return histogram_; }

References histogram_.

Referenced by BaseLib::operator<<(), and write().

getBinWidth()

template<typename T>

const T & BaseLib::Histogram< T >::getBinWidth ( ) const

inline

Definition at line 114 of file Histogram.h.

{ return bin_width_; }

References bin_width_.

Referenced by write().

getMaximum()

template<typename T>

const T & BaseLib::Histogram< T >::getMaximum ( ) const

inline

Definition at line 113 of file Histogram.h.

{ return max_; }

References max_.

Referenced by BaseLib::operator<<().

getMinimum()

template<typename T>

const T & BaseLib::Histogram< T >::getMinimum ( ) const

inline

Definition at line 112 of file Histogram.h.

{ return min_; }

References min_.

Referenced by BaseLib::operator<<(), and write().

getNumberOfBins()

template<typename T>

const unsigned int & BaseLib::Histogram< T >::getNumberOfBins ( ) const

inline

Definition at line 111 of file Histogram.h.

{ return nr_bins_; }

References nr_bins_.

Referenced by BaseLib::operator<<(), and write().

getSortedData()

template<typename T>

const Data & BaseLib::Histogram< T >::getSortedData ( ) const

inline

Definition at line 109 of file Histogram.h.

{ return data_; }

References data_.

init()

template<typename T>

void BaseLib::Histogram< T >::init ( const bool computeHistogram = true )

inlineprotected

Initialize class members after constructor call.

Definition at line 125 of file Histogram.h.

    {
        std::sort(data_.begin(), data_.end());
        histogram_.resize(nr_bins_);
        min_ = data_.front();
        max_ = data_.back();
        bin_width_ = (max_ - min_) / nr_bins_;
 
        dirty_ = true;
        if (computeHistogram)
        {
            update();
        }
    }

References bin_width_, data_, dirty_, histogram_, max_, min_, nr_bins_, and update().

Referenced by Histogram(), and Histogram().

prettyPrint()

template<typename T>

void BaseLib::Histogram< T >::prettyPrint	(	std::ostream &	os,
		const unsigned int	line_width = 16 ) const

Definition at line 55 of file Histogram.cpp.

{
    const std::size_t count_max =
        *std::max_element(histogram_.begin(), histogram_.end());
    for (unsigned int bin = 0; bin < nr_bins_; ++bin)
    {
        os << "[" << min_ + bin * bin_width_ << ", "
           << min_ + (bin + 1) * bin_width_ << ")\t";
        os << histogram_[bin] << "\t";
 
        const int n_stars = static_cast<int>(
            std::ceil(line_width * ((double)histogram_[bin] / count_max)));
        for (int star = 0; star < n_stars; star++)
        {
            os << "*";
        }
        os << "\n";
    }
}

References bin_width_, histogram_, min_, and nr_bins_.

setMaximum()

template<typename T>

void BaseLib::Histogram< T >::setMaximum ( const T & maximum )

inline

Definition at line 103 of file Histogram.h.

    {
        max_ = maximum;
        dirty_ = true;
    }

References dirty_, and max_.

setMinimum()

template<typename T>

void BaseLib::Histogram< T >::setMinimum ( const T & minimum )

inline

Definition at line 98 of file Histogram.h.

    {
        min_ = minimum;
        dirty_ = true;
    }

References dirty_, and min_.

update()

template<typename T>

void BaseLib::Histogram< T >::update ( )

inline

Updates histogram using sorted data_ vector.

Start histogram creation with first element. Then find first element in the next histogram bin. Number of elements in the bin is the difference between these two iterators.

[0.1, 0.2, ..., 0.7 , ..., 0.7+binWidth = 0.9,  1.0  , ..., last]
                it             itEnd - 1      itEnd

Definition at line 78 of file Histogram.h.

    {
        if (!dirty_)
        {
            return;
        }
 
        bin_width_ = (max_ - min_) / nr_bins_;
 
        auto it = data_.begin();
        for (unsigned int bin = 0; bin < nr_bins_; bin++)
        {
            auto itEnd = std::upper_bound(it, data_.end(),
                                          min_ + (bin + 1) * bin_width_);
            histogram_[bin] = std::distance(it, itEnd);
            it = itEnd;
        }
        dirty_ = false;
    }

References bin_width_, data_, dirty_, histogram_, max_, min_, and nr_bins_.

Referenced by init().

write()

template<typename T>

int BaseLib::Histogram< T >::write	(	std::string const &	file_name,
		std::string const &	data_set_name,
		std::string const &	param_name ) const

Definition at line 22 of file Histogram.cpp.

{
    if (file_name.empty())
    {
        ERR("No file name specified.");
        return 1;
    }
 
    std::ofstream out(file_name);
    if (!out)
    {
        ERR("Error writing histogram: Could not open file.");
        return 1;
    }
 
    out << "# Histogram for parameter " << param_name << " of data set "
        << data_set_name << "\n";
    std::size_t const n_bins = this->getNumberOfBins();
    std::vector<std::size_t> const& bin_cnts(this->getBinCounts());
    double const min(this->getMinimum());
    double const bin_width(this->getBinWidth());
 
    for (std::size_t k(0); k < n_bins; k++)
    {
        out << min + k * bin_width << " " << bin_cnts[k] << "\n";
    }
    out.close();
    return 0;
}

References ERR(), getBinCounts(), getBinWidth(), getMinimum(), and getNumberOfBins().

Referenced by MeshToolsLib::ElementQualityInterface::writeHistogram().

Member Data Documentation

bin_width_

template<typename T>

T BaseLib::Histogram< T >::bin_width_

protected

Definition at line 144 of file Histogram.h.

Referenced by getBinWidth(), init(), prettyPrint(), and update().

data_

template<typename T>

Data BaseLib::Histogram< T >::data_

protected

Definition at line 140 of file Histogram.h.

Referenced by Histogram(), Histogram(), getSortedData(), init(), and update().

dirty_

template<typename T>

bool BaseLib::Histogram< T >::dirty_

private

When set update() will recompute histogram.

Definition at line 147 of file Histogram.h.

Referenced by Histogram(), Histogram(), init(), setMaximum(), setMinimum(), and update().

histogram_

template<typename T>

std::vector<std::size_t> BaseLib::Histogram< T >::histogram_

protected

Definition at line 142 of file Histogram.h.

Referenced by getBinCounts(), init(), prettyPrint(), and update().

max_

template<typename T>

T BaseLib::Histogram< T >::max_

protected

Minimum and maximum input data values.

Definition at line 143 of file Histogram.h.

Referenced by getMaximum(), init(), setMaximum(), and update().

min_

template<typename T>

T BaseLib::Histogram< T >::min_

protected

Definition at line 143 of file Histogram.h.

Referenced by getMinimum(), init(), prettyPrint(), setMinimum(), and update().

nr_bins_

template<typename T>

const unsigned int BaseLib::Histogram< T >::nr_bins_

protected

Definition at line 141 of file Histogram.h.

Referenced by Histogram(), Histogram(), getNumberOfBins(), init(), prettyPrint(), and update().

---

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

• BaseLib/Histogram.h
• BaseLib/Histogram.cpp