Histogram1D Class Reference

Inheritance diagram for Histogram1D:

Collaboration diagram for Histogram1D:

Public Types
enum	DataType { INTEGRAL , AVERAGE , STANDARD_ERROR , NENTRIES }

Public Member Functions
	Histogram1D (int nbinsx, double xlow, double xup)
	Histogram1D (int nbinsx, const std::vector< double > &xbins)
	Histogram1D (const IAxis &axis)
	Histogram1D (const OutputData< double > &data)
Histogram1D *	clone () const
size_t	getRank () const
int	fill (double x, double weight=1.0)
std::vector< double >	getBinCenters () const
std::vector< double >	getBinValues () const
std::vector< double >	getBinErrors () const
PyObject *	getBinCentersNumpy () const
PyObject *	getBinValuesNumpy () const
PyObject *	getBinErrorsNumpy () const
Histogram1D *	crop (double xmin, double xmax)
size_t	getTotalNumberOfBins () const
const IAxis &	getXaxis () const
const IAxis &	getYaxis () const
double	getXmin () const
double	getXmax () const
size_t	getNbinsX () const
double	getYmin () const
double	getYmax () const
size_t	getNbinsY () const
size_t	getGlobalBin (size_t binx, size_t biny=0) const
size_t	findGlobalBin (double x, double y) const
size_t	getXaxisIndex (size_t i) const
size_t	getYaxisIndex (size_t i) const
double	getXaxisValue (size_t i)
double	getYaxisValue (size_t i)
double	getBinContent (size_t i) const
double	getBinContent (size_t binx, size_t biny) const
const OutputData< CumulativeValue > &	getData () const
OutputData< CumulativeValue > &	getData ()
void	setBinContent (size_t i, double value)
void	addBinContent (size_t i, double value)
double	getBinError (size_t i) const
double	getBinError (size_t binx, size_t biny) const
double	getBinAverage (size_t i) const
double	getBinAverage (size_t binx, size_t biny) const
int	getBinNumberOfEntries (size_t i) const
int	getBinNumberOfEntries (size_t binx, size_t biny) const
double	getMaximum () const
size_t	getMaximumBinIndex () const
double	getMinimum () const
size_t	getMinimumBinIndex () const
void	scale (double value)
double	integral () const
PyObject *	array (DataType dataType=DataType::INTEGRAL) const
PyObject *	getArray (DataType dataType=DataType::INTEGRAL) const
void	reset ()
OutputData< double > *	createOutputData (DataType dataType=DataType::INTEGRAL) const
bool	hasSameShape (const IHistogram &other) const
bool	hasSameDimensions (const IHistogram &other) const
const IHistogram &	operator+= (const IHistogram &right)
IHistogram *	relativeDifferenceHistogram (const IHistogram &rhs)
void	save (const std::string &filename)
void	load (const std::string &filename)

Static Public Member Functions
static IHistogram *	createHistogram (const OutputData< double > &source)
static IHistogram *	createFrom (const std::string &filename)
static IHistogram *	createFrom (const std::vector< std::vector< double >> &data)

Protected Member Functions
void	check_x_axis () const
void	check_y_axis () const
void	init_from_data (const OutputData< double > &source)
double	getBinData (size_t i, DataType dataType) const
std::vector< double >	getDataVector (DataType dataType) const
void	copyContentFrom (const IHistogram &other)

Protected Attributes
OutputData< CumulativeValue >	m_data

Detailed Description

One dimensional histogram.

Definition at line 23 of file Histogram1D.h.

Member Enumeration Documentation

DataType

enum IHistogram::DataType

inherited

Enumerator
INTEGRAL
AVERAGE
STANDARD_ERROR
NENTRIES

Definition at line 29 of file IHistogram.h.

{ INTEGRAL, AVERAGE, STANDARD_ERROR, NENTRIES };

Constructor & Destructor Documentation

Histogram1D() [1/4]

Histogram1D::Histogram1D	(	int	nbinsx,
		double	xlow,
		double	xup
	)

Constructor for fix bin size histograms.

Parameters

nbinsx	number of bins
xlow	low edge of the first bin
xup	upper edge of the last bin

Definition at line 20 of file Histogram1D.cpp.

{
    m_data.addAxis(FixedBinAxis("x-axis", nbinsx, xlow, xup));
}

References OutputData< T >::addAxis(), and IHistogram::m_data.

Referenced by clone(), and crop().

Here is the call graph for this function:

Histogram1D() [2/4]

Histogram1D::Histogram1D	(	int	nbinsx,
		const std::vector< double > &	xbins
	)

Constructor for variable bin size histograms.

Parameters

nbinsx	number of bins
xbins	Array of size nbins+1 containing low-edges for each bin and upper edge of last bin.

Definition at line 25 of file Histogram1D.cpp.

{
    m_data.addAxis(VariableBinAxis("x-axis", nbinsx, xbins));
}

References OutputData< T >::addAxis(), and IHistogram::m_data.

Here is the call graph for this function:

Histogram1D() [3/4]

Histogram1D::Histogram1D

(

const IAxis &

axis

)

Constructor for 1D histogram with custom axis.

Definition at line 30 of file Histogram1D.cpp.

: IHistogram(axis) {}

Histogram1D() [4/4]

Histogram1D::Histogram1D

(

const OutputData< double > &

data

)

Constructor for 1D histograms from basic OutputData object.

Definition at line 32 of file Histogram1D.cpp.

{
    init_from_data(data);
}

References IHistogram::init_from_data().

Here is the call graph for this function:

Member Function Documentation

clone()

Histogram1D * Histogram1D::clone ( ) const

virtual

Returns clone of other histogram.

Implements IHistogram.

Definition at line 37 of file Histogram1D.cpp.

{
    return new Histogram1D(*this);
}

References Histogram1D().

Here is the call graph for this function:

getRank()

size_t Histogram1D::getRank ( ) const

inlinevirtual

Returns the number of histogram dimensions.

Implements IHistogram.

Definition at line 48 of file Histogram1D.h.

{ return 1; }

fill()

int Histogram1D::fill	(	double	x,
		double	weight = 1.0
	)

Increment bin with abscissa x with a weight.

Definition at line 42 of file Histogram1D.cpp.

{
    const IAxis& axis = getXaxis();
    if (x < axis.getMin() || x >= axis.getMax())
        return -1;
    size_t index = axis.findClosestIndex(x);
    m_data[index].add(weight);
    return (int)index;
}

References IAxis::findClosestIndex(), IAxis::getMax(), IAxis::getMin(), IHistogram::getXaxis(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionX(), and Histogram2D::create_projectionY().

Here is the call graph for this function:

getBinCenters()

std::vector< double > Histogram1D::getBinCenters

(

)

const

returns vector of histogram bin centers

Definition at line 52 of file Histogram1D.cpp.

{
    return getXaxis().getBinCenters();
}

References IAxis::getBinCenters(), and IHistogram::getXaxis().

Referenced by getBinCentersNumpy().

Here is the call graph for this function:

getBinValues()

std::vector< double > Histogram1D::getBinValues

(

)

const

returns vector of bin content (the value accumulated by bins)

Definition at line 57 of file Histogram1D.cpp.

{
    return IHistogram::getDataVector(IHistogram::DataType::INTEGRAL);
}

References IHistogram::getDataVector().

Referenced by getBinValuesNumpy().

Here is the call graph for this function:

getBinErrors()

std::vector< double > Histogram1D::getBinErrors

(

)

const

returns vector of bin errors

Definition at line 62 of file Histogram1D.cpp.

{
    return IHistogram::getDataVector(IHistogram::DataType::STANDARD_ERROR);
}

References IHistogram::getDataVector().

Referenced by getBinErrorsNumpy().

Here is the call graph for this function:

getBinCentersNumpy()

PyObject * Histogram1D::getBinCentersNumpy

(

)

const

Definition at line 69 of file Histogram1D.cpp.

{
    return ArrayUtils::createNumpyArray(getBinCenters());
}

References ArrayUtils::createNumpyArray(), and getBinCenters().

Here is the call graph for this function:

getBinValuesNumpy()

PyObject * Histogram1D::getBinValuesNumpy

(

)

const

Definition at line 74 of file Histogram1D.cpp.

{
    return ArrayUtils::createNumpyArray(getBinValues());
}

References ArrayUtils::createNumpyArray(), and getBinValues().

Here is the call graph for this function:

getBinErrorsNumpy()

PyObject * Histogram1D::getBinErrorsNumpy

(

)

const

Definition at line 79 of file Histogram1D.cpp.

{
    return ArrayUtils::createNumpyArray(getBinErrors());
}

References ArrayUtils::createNumpyArray(), and getBinErrors().

Here is the call graph for this function:

crop()

Histogram1D * Histogram1D::crop	(	double	xmin,
		double	xmax
	)

Creates new histogram by applying crop on axis.

Definition at line 86 of file Histogram1D.cpp.

{
    const std::unique_ptr<IAxis> xaxis(getXaxis().createClippedAxis(xmin, xmax));
    Histogram1D* result = new Histogram1D(*xaxis);
    OutputData<CumulativeValue>::const_iterator it_origin = m_data.begin();
    OutputData<CumulativeValue>::iterator it_result = result->m_data.begin();
    while (it_origin != m_data.end()) {
        double x = m_data.getAxisValue(it_origin.getIndex(), 0);
        if (result->getXaxis().contains(x)) {
            *it_result = *it_origin;
            ++it_result;
        }
        ++it_origin;
    }
    return result;
}

References OutputData< T >::begin(), IAxis::contains(), OutputData< T >::end(), OutputData< T >::getAxisValue(), IHistogram::getXaxis(), Histogram1D(), and IHistogram::m_data.

Here is the call graph for this function:

getTotalNumberOfBins()

size_t IHistogram::getTotalNumberOfBins ( ) const

inherited

Returns total number of histogram bins.

For 2D histograms the result will be the product of bin numbers along X and Y axes.

Definition at line 39 of file IHistogram.cpp.

{
    return m_data.getAllocatedSize();
}

References OutputData< T >::getAllocatedSize(), and IHistogram::m_data.

Referenced by IHistogram::copyContentFrom(), Histogram2D::create_projectionX(), Histogram2D::create_projectionY(), IHistogram::createOutputData(), IHistogram::getDataVector(), IHistogram::integral(), IHistogram::operator+=(), IHistogram::relativeDifferenceHistogram(), and IHistogram::scale().

Here is the call graph for this function:

getXaxis()

const IAxis & IHistogram::getXaxis ( ) const

inherited

returns x-axis

Definition at line 44 of file IHistogram.cpp.

{
    check_x_axis();
    return m_data.getAxis(0);
}

References IHistogram::check_x_axis(), OutputData< T >::getAxis(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionX(), crop(), Histogram2D::crop(), fill(), Histogram2D::fill(), SpectrumUtils::FindPeaks(), getBinCenters(), IHistogram::getNbinsX(), IHistogram::getXmax(), IHistogram::getXmin(), Histogram2D::projectionX(), and Histogram2D::projectionY().

Here is the call graph for this function:

getYaxis()

const IAxis & IHistogram::getYaxis ( ) const

inherited

returns y-axis for 2D histograms

Definition at line 50 of file IHistogram.cpp.

{
    check_y_axis();
    return m_data.getAxis(1);
}

References IHistogram::check_y_axis(), OutputData< T >::getAxis(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionY(), Histogram2D::crop(), Histogram2D::fill(), SpectrumUtils::FindPeaks(), IHistogram::getNbinsY(), IHistogram::getYmax(), IHistogram::getYmin(), and Histogram2D::projectionX().

Here is the call graph for this function:

getXmin()

double IHistogram::getXmin ( ) const

inherited

Returns x-axis min (lower edge of first bin).

Definition at line 56 of file IHistogram.cpp.

{
    return getXaxis().getMin();
}

References IAxis::getMin(), and IHistogram::getXaxis().

Here is the call graph for this function:

getXmax()

double IHistogram::getXmax ( ) const

inherited

Returns x-axis max (upper edge of last bin).

Definition at line 61 of file IHistogram.cpp.

{
    return getXaxis().getMax();
}

References IAxis::getMax(), and IHistogram::getXaxis().

Here is the call graph for this function:

getNbinsX()

size_t IHistogram::getNbinsX ( ) const

inherited

Returns number of bins on x-axis.

Definition at line 66 of file IHistogram.cpp.

{
    return getXaxis().size();
}

References IHistogram::getXaxis(), and IAxis::size().

Here is the call graph for this function:

getYmin()

double IHistogram::getYmin ( ) const

inherited

Returns y-axis min (lower edge of first bin) for 2D histograms.

Definition at line 71 of file IHistogram.cpp.

{
    return getYaxis().getMin();
}

References IAxis::getMin(), and IHistogram::getYaxis().

Here is the call graph for this function:

getYmax()

double IHistogram::getYmax ( ) const

inherited

Returns y-axis max (upper edge of last bin) for 2D histograms.

Definition at line 76 of file IHistogram.cpp.

{
    return getYaxis().getMax();
}

References IAxis::getMax(), and IHistogram::getYaxis().

Here is the call graph for this function:

getNbinsY()

size_t IHistogram::getNbinsY ( ) const

inherited

Returns number of bins on y-axis.

Definition at line 81 of file IHistogram.cpp.

{
    return getYaxis().size();
}

References IHistogram::getYaxis(), and IAxis::size().

Here is the call graph for this function:

getGlobalBin()

size_t IHistogram::getGlobalBin ( size_t  binx, size_t  biny = 0  ) const

inherited

Returns global bin index for given axes indices. For 1D, just returns binx.

Definition at line 86 of file IHistogram.cpp.

{
    std::vector<unsigned> axes_indices;
    axes_indices.push_back(static_cast<unsigned>(binx));
    if (getRank() == 2)
        axes_indices.push_back(static_cast<unsigned>(biny));
    return m_data.toGlobalIndex(axes_indices);
}

References IHistogram::getRank(), IHistogram::m_data, and OutputData< T >::toGlobalIndex().

Referenced by IHistogram::getBinAverage(), IHistogram::getBinContent(), IHistogram::getBinError(), and IHistogram::getBinNumberOfEntries().

Here is the call graph for this function:

findGlobalBin()

size_t IHistogram::findGlobalBin ( double  x, double  y  ) const

inherited

Returns closest global bin index for given axes coordinates.

Definition at line 95 of file IHistogram.cpp.

{
    std::vector<double> coordinates;
    coordinates.push_back(x);
    if (getRank() == 2)
        coordinates.push_back(y);
    return m_data.findGlobalIndex(coordinates);
}

References OutputData< T >::findGlobalIndex(), IHistogram::getRank(), and IHistogram::m_data.

Here is the call graph for this function:

getXaxisIndex()

size_t IHistogram::getXaxisIndex ( size_t  i ) const

inherited

Returns x-axis index for global bin index i.

Definition at line 104 of file IHistogram.cpp.

{
    return m_data.getAxisBinIndex(i, 0);
}

References OutputData< T >::getAxisBinIndex(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionY().

Here is the call graph for this function:

getYaxisIndex()

size_t IHistogram::getYaxisIndex ( size_t  i ) const

inherited

Returns y-axis index for global bin index i.

Definition at line 109 of file IHistogram.cpp.

{
    return m_data.getAxisBinIndex(i, 1);
}

References OutputData< T >::getAxisBinIndex(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionX().

Here is the call graph for this function:

getXaxisValue()

double IHistogram::getXaxisValue ( size_t  i )

inherited

Returns the center of bin i of the x axis.

Definition at line 114 of file IHistogram.cpp.

{
    check_x_axis();
    return m_data.getAxisValue(i, 0);
}

References IHistogram::check_x_axis(), OutputData< T >::getAxisValue(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionX().

Here is the call graph for this function:

getYaxisValue()

double IHistogram::getYaxisValue ( size_t  i )

inherited

Returns the center of bin i of the y axis.

Definition at line 120 of file IHistogram.cpp.

{
    check_y_axis();
    return m_data.getAxisValue(i, 1);
}

References IHistogram::check_y_axis(), OutputData< T >::getAxisValue(), and IHistogram::m_data.

Referenced by Histogram2D::create_projectionY().

Here is the call graph for this function:

getBinContent() [1/2]

double IHistogram::getBinContent ( size_t  i ) const

inherited

Returns content (accumulated value) of bin i.

Definition at line 126 of file IHistogram.cpp.

{
    return m_data[i].getContent();
}

References IHistogram::m_data.

Referenced by Histogram2D::create_projectionX(), Histogram2D::create_projectionY(), IHistogram::getBinContent(), IHistogram::getBinData(), IHistogram::operator+=(), and IHistogram::relativeDifferenceHistogram().

getBinContent() [2/2]

double IHistogram::getBinContent ( size_t  binx, size_t  biny  ) const

inherited

Returns content (accumulated value) of the 2D histogram bin.

Definition at line 131 of file IHistogram.cpp.

{
    return getBinContent(getGlobalBin(binx, biny));
}

References IHistogram::getBinContent(), and IHistogram::getGlobalBin().

Here is the call graph for this function:

getData() [1/2]

const OutputData<CumulativeValue>& IHistogram::getData ( ) const

inlineinherited

Definition at line 92 of file IHistogram.h.

{ return m_data; }

References IHistogram::m_data.

Referenced by IntensityDataFunctions::getRelativeDifference().

getData() [2/2]

OutputData<CumulativeValue>& IHistogram::getData ( )

inlineinherited

Definition at line 93 of file IHistogram.h.

{ return m_data; }

References IHistogram::m_data.

setBinContent()

void IHistogram::setBinContent ( size_t  i, double  value  )

inherited

Sets content of the bin corresponding to the globalbin number.

Definition at line 136 of file IHistogram.cpp.

{
    m_data[i].setContent(value);
}

References IHistogram::m_data.

Referenced by IHistogram::relativeDifferenceHistogram().

addBinContent()

void IHistogram::addBinContent ( size_t  i, double  value  )

inherited

Add the value to the bin.

Definition at line 141 of file IHistogram.cpp.

{
    m_data[i].add(value);
}

References IHistogram::m_data.

Referenced by IHistogram::operator+=().

getBinError() [1/2]

double IHistogram::getBinError ( size_t  i ) const

inherited

Returns error of the bin with given index.

Definition at line 146 of file IHistogram.cpp.

{
    return m_data[i].getRMS();
}

References IHistogram::m_data.

Referenced by IHistogram::getBinData(), and IHistogram::getBinError().

getBinError() [2/2]

double IHistogram::getBinError ( size_t  binx, size_t  biny  ) const

inherited

Returns error of the bin with given indices (for 2D histograms).

Definition at line 151 of file IHistogram.cpp.

{
    return getBinError(getGlobalBin(binx, biny));
}

References IHistogram::getBinError(), and IHistogram::getGlobalBin().

Here is the call graph for this function:

getBinAverage() [1/2]

double IHistogram::getBinAverage ( size_t  i ) const

inherited

Returns average value in the bin with given index.

Definition at line 156 of file IHistogram.cpp.

{
    return m_data[i].getAverage();
}

References IHistogram::m_data.

Referenced by IHistogram::getBinAverage(), and IHistogram::getBinData().

getBinAverage() [2/2]

double IHistogram::getBinAverage ( size_t  binx, size_t  biny  ) const

inherited

Returns average value of the bin with given indices (for 2D histograms).

Definition at line 161 of file IHistogram.cpp.

{
    return getBinAverage(getGlobalBin(binx, biny));
}

References IHistogram::getBinAverage(), and IHistogram::getGlobalBin().

Here is the call graph for this function:

getBinNumberOfEntries() [1/2]

int IHistogram::getBinNumberOfEntries ( size_t  i ) const

inherited

Returns number of entries in the bin with given index.

Definition at line 166 of file IHistogram.cpp.

{
    return m_data[i].getNumberOfEntries();
}

References IHistogram::m_data.

Referenced by IHistogram::getBinData(), and IHistogram::getBinNumberOfEntries().

getBinNumberOfEntries() [2/2]

int IHistogram::getBinNumberOfEntries ( size_t  binx, size_t  biny  ) const

inherited

Returns number of entries in the bin with given indices (for 2D histograms).

Definition at line 171 of file IHistogram.cpp.

{
    return getBinNumberOfEntries(getGlobalBin(binx, biny));
}

References IHistogram::getBinNumberOfEntries(), and IHistogram::getGlobalBin().

Here is the call graph for this function:

getMaximum()

double IHistogram::getMaximum ( ) const

inherited

Returns histogram maximum value (maximum of getBinContent() over all bins)

Definition at line 176 of file IHistogram.cpp.

{
    OutputData<CumulativeValue>::const_iterator it = std::max_element(m_data.begin(), m_data.end());
    return it->getContent();
}

References OutputData< T >::begin(), OutputData< T >::end(), and IHistogram::m_data.

Here is the call graph for this function:

getMaximumBinIndex()

size_t IHistogram::getMaximumBinIndex ( ) const

inherited

Returns globalbin index with maximum content.

Definition at line 182 of file IHistogram.cpp.

{
    OutputData<CumulativeValue>::const_iterator it = std::max_element(m_data.begin(), m_data.end());
    return std::distance(m_data.begin(), it);
}

References OutputData< T >::begin(), OutputData< T >::end(), and IHistogram::m_data.

Here is the call graph for this function:

getMinimum()

double IHistogram::getMinimum ( ) const

inherited

Returns histogram minimum value (minimum of getBinContent() over all bins)

Definition at line 188 of file IHistogram.cpp.

{
    OutputData<CumulativeValue>::const_iterator it = std::min_element(m_data.begin(), m_data.end());
    return it->getContent();
}

References OutputData< T >::begin(), OutputData< T >::end(), and IHistogram::m_data.

Here is the call graph for this function:

getMinimumBinIndex()

size_t IHistogram::getMinimumBinIndex ( ) const

inherited

Returns globalbin index with minimum content.

Definition at line 194 of file IHistogram.cpp.

{
    return std::distance(m_data.begin(), std::min_element(m_data.begin(), m_data.end()));
}

References OutputData< T >::begin(), OutputData< T >::end(), and IHistogram::m_data.

Here is the call graph for this function:

scale()

void IHistogram::scale ( double  value )

inherited

Multiply this histogram (every bin content value) by a constant.

Definition at line 199 of file IHistogram.cpp.

{
    for (size_t index = 0; index < getTotalNumberOfBins(); ++index) {
        m_data[index].setContent(value * m_data[index].getContent());
    }
}

References IHistogram::getTotalNumberOfBins(), and IHistogram::m_data.

Here is the call graph for this function:

integral()

double IHistogram::integral ( ) const

inherited

Returns integral of bins content (computed as a sum of all bin content).

Definition at line 206 of file IHistogram.cpp.

{
    double result(0.0);
    for (size_t index = 0; index < getTotalNumberOfBins(); ++index) {
        result += m_data[index].getContent();
    }
    return result;
}

References IHistogram::getTotalNumberOfBins(), and IHistogram::m_data.

Here is the call graph for this function:

array()

PyObject * IHistogram::array ( DataType  dataType = DataType::INTEGRAL ) const

inherited

Returns numpy array with bin content (accumulated values).

Definition at line 216 of file IHistogram.cpp.

{
    const std::unique_ptr<OutputData<double>> data(createOutputData(dataType));
    return data->getArray();
}

References IHistogram::createOutputData().

Referenced by IHistogram::getArray().

Here is the call graph for this function:

getArray()

PyObject * IHistogram::getArray ( DataType  dataType = DataType::INTEGRAL ) const

inherited

Deprecated:

Use array() instead.

Definition at line 222 of file IHistogram.cpp.

{
    return array(dataType);
}

References IHistogram::array().

Here is the call graph for this function:

reset()

void IHistogram::reset ( )

inherited

Reset histogram content (axes remains)

Definition at line 228 of file IHistogram.cpp.

{
    m_data.setAllTo(CumulativeValue());
}

References IHistogram::m_data, and OutputData< T >::setAllTo().

Referenced by IHistogram::copyContentFrom(), IHistogram::relativeDifferenceHistogram(), and Histogram2D::setContent().

Here is the call graph for this function:

createHistogram()

IHistogram * IHistogram::createHistogram ( const OutputData< double > &  source )

staticinherited

Definition at line 233 of file IHistogram.cpp.

{
    if (source.getRank() == 1) {
        return new Histogram1D(source);
    } else if (source.getRank() == 2) {
        return new Histogram2D(source);
    } else {
        std::ostringstream message;
        message << "IHistogram::createHistogram(const OutputData<double>& source) -> Error. ";
        message << "The rank of source " << source.getRank() << " ";
        message << "is not suitable for creation neither 1-dim nor 2-dim histograms.";
        throw Exceptions::LogicErrorException(message.str());
    }
}

References OutputData< T >::getRank().

Referenced by DetectorMask::createHistogram(), and IntensityDataIOFactory::readIntensityData().

Here is the call graph for this function:

createFrom() [1/2]

IHistogram * IHistogram::createFrom ( const std::string &  filename )

staticinherited

create new histogram from file content

Definition at line 248 of file IHistogram.cpp.

{
    return IntensityDataIOFactory::readIntensityData(filename);
}

References FileSystemUtils::filename(), and IntensityDataIOFactory::readIntensityData().

Here is the call graph for this function:

createFrom() [2/2]

IHistogram * IHistogram::createFrom ( const std::vector< std::vector< double >> &  data )

staticinherited

create new histogram from numpy array

Definition at line 253 of file IHistogram.cpp.

{
    return new Histogram2D(data);
}

createOutputData()

OutputData< double > * IHistogram::createOutputData ( IHistogram::DataType  dataType = DataType::INTEGRAL ) const

inherited

creates new OutputData with histogram's shape and values corresponding to DataType

creates new OutputData with histogram's shape and put there values corresponding to DataType

Definition at line 334 of file IHistogram.cpp.

{
    OutputData<double>* result = new OutputData<double>;
    result->copyShapeFrom(m_data);
    for (size_t i = 0; i < getTotalNumberOfBins(); ++i) {
        (*result)[i] = getBinData(i, dataType);
    }
    return result;
}

References OutputData< T >::copyShapeFrom(), IHistogram::getBinData(), IHistogram::getTotalNumberOfBins(), and IHistogram::m_data.

Referenced by IHistogram::array(), SpectrumUtils::FindPeaks(), and IntensityDataIOFactory::writeIntensityData().

Here is the call graph for this function:

hasSameShape()

bool IHistogram::hasSameShape ( const IHistogram &  other ) const

inherited

Returns true if objects a) have same dimensions b) bin boundaries of axes coincide.

Definition at line 344 of file IHistogram.cpp.

{
    return m_data.hasSameShape(other.m_data);
}

References OutputData< T >::hasSameShape(), and IHistogram::m_data.

Here is the call graph for this function:

hasSameDimensions()

bool IHistogram::hasSameDimensions ( const IHistogram &  other ) const

inherited

Returns true if object have same rank and number of axes bins.

Definition at line 349 of file IHistogram.cpp.

{
    return m_data.hasSameDimensions(other.m_data);
}

References OutputData< T >::hasSameDimensions(), and IHistogram::m_data.

Referenced by IHistogram::copyContentFrom(), IHistogram::operator+=(), and IHistogram::relativeDifferenceHistogram().

Here is the call graph for this function:

operator+=()

const IHistogram & IHistogram::operator+= ( const IHistogram &  right )

inherited

addition-assignment operator for two histograms

Definition at line 354 of file IHistogram.cpp.

{
    if (!hasSameDimensions(right))
        throw Exceptions::LogicErrorException(
            "IHistogram::operator+=() -> Error. Histograms have different dimension");
    for (size_t i = 0; i < getTotalNumberOfBins(); ++i)
        addBinContent(i, right.getBinContent(i));
    return *this;
}

References IHistogram::addBinContent(), IHistogram::getBinContent(), IHistogram::getTotalNumberOfBins(), and IHistogram::hasSameDimensions().

Here is the call graph for this function:

relativeDifferenceHistogram()

IHistogram * IHistogram::relativeDifferenceHistogram ( const IHistogram &  rhs )

inherited

returns histogram representing relative difference of two histograms.

Definition at line 364 of file IHistogram.cpp.

{
    if (!hasSameDimensions(rhs))
        throw Exceptions::LogicErrorException("IHistogram::relativeDifferenceHistogram() -> Error. "
                                              "Histograms have different dimensions");
 
    IHistogram* result = this->clone();
    result->reset();
 
    for (size_t i = 0; i < getTotalNumberOfBins(); ++i) {
        double diff = Numeric::GetRelativeDifference(getBinContent(i), rhs.getBinContent(i));
        result->setBinContent(i, diff);
    }
    return result;
}

References IHistogram::clone(), IHistogram::getBinContent(), Numeric::GetRelativeDifference(), IHistogram::getTotalNumberOfBins(), IHistogram::hasSameDimensions(), IHistogram::reset(), and IHistogram::setBinContent().

Here is the call graph for this function:

save()

void IHistogram::save ( const std::string &  filename )

inherited

Saves histogram in file Following formats are available: *.txt, *.tif, *.int (*.txt.gz, *.tif.gz, *.int.gz)

Definition at line 380 of file IHistogram.cpp.

{
    IntensityDataIOFactory::writeIntensityData(*this, filename);
}

References FileSystemUtils::filename(), and IntensityDataIOFactory::writeIntensityData().

Here is the call graph for this function:

load()

void IHistogram::load ( const std::string &  filename )

inherited

Loads histogram from file, the shape of array in file should match Following formats are available: *.txt, *.tif, *.int (*.txt.gz, *.tif.gz, *.int.gz) Only bin content will be loaded, histogram axes remain the same.

Definition at line 385 of file IHistogram.cpp.

{
    const std::unique_ptr<IHistogram> hist(IntensityDataIOFactory::readIntensityData(filename));
    copyContentFrom(*hist);
}

References IHistogram::copyContentFrom(), FileSystemUtils::filename(), and IntensityDataIOFactory::readIntensityData().

Here is the call graph for this function:

check_x_axis()

void IHistogram::check_x_axis ( ) const

protectedinherited

Definition at line 258 of file IHistogram.cpp.

{
    if (getRank() < 1) {
        std::ostringstream message;
        message << "IHistogram::check_x_axis() -> Error. X-xis does not exist. ";
        message << "Rank of histogram " << getRank() << "." << std::endl;
        throw Exceptions::LogicErrorException(message.str());
    }
}

References IHistogram::getRank().

Referenced by IHistogram::getXaxis(), and IHistogram::getXaxisValue().

Here is the call graph for this function:

check_y_axis()

void IHistogram::check_y_axis ( ) const

protectedinherited

Definition at line 268 of file IHistogram.cpp.

{
    if (getRank() < 2) {
        std::ostringstream message;
        message << "IHistogram::check_y_axis() -> Error. Y-axis does not exist. ";
        message << "Rank of histogram " << getRank() << "." << std::endl;
        throw Exceptions::LogicErrorException(message.str());
    }
}

References IHistogram::getRank().

Referenced by IHistogram::getYaxis(), and IHistogram::getYaxisValue().

Here is the call graph for this function:

init_from_data()

void IHistogram::init_from_data ( const OutputData< double > &  source )

protectedinherited

Definition at line 278 of file IHistogram.cpp.

{
    if (getRank() != source.getRank()) {
        std::ostringstream message;
        message << "IHistogram::IHistogram(const OutputData<double>& data) -> Error. ";
        message << "The dimension of this histogram " << getRank() << " ";
        message << "is differ from the dimension of source " << m_data.getRank() << std::endl;
        throw Exceptions::LogicErrorException(message.str());
    }
 
    m_data.copyShapeFrom(source);
    for (size_t i = 0; i < source.getAllocatedSize(); ++i) {
        m_data[i].add(source[i]);
    }
}

References OutputData< T >::copyShapeFrom(), OutputData< T >::getAllocatedSize(), OutputData< T >::getRank(), IHistogram::getRank(), and IHistogram::m_data.

Referenced by Histogram1D(), and Histogram2D::Histogram2D().

Here is the call graph for this function:

getBinData()

double IHistogram::getBinData ( size_t  i, IHistogram::DataType  dataType  ) const

protectedinherited

returns data of requested type for globalbin number

Definition at line 295 of file IHistogram.cpp.

{
    if (dataType == DataType::INTEGRAL) {
        return getBinContent(i);
    } else if (dataType == DataType::AVERAGE) {
        return getBinAverage(i);
    } else if (dataType == DataType::STANDARD_ERROR) {
        return getBinError(i);
    } else if (dataType == DataType::NENTRIES) {
        return getBinNumberOfEntries(i);
    } else
        throw Exceptions::LogicErrorException(
            "IHistogram::getBinData() -> Error. Unknown data type.");
}

References IHistogram::getBinAverage(), IHistogram::getBinContent(), IHistogram::getBinError(), and IHistogram::getBinNumberOfEntries().

Referenced by IHistogram::createOutputData(), and IHistogram::getDataVector().

Here is the call graph for this function:

getDataVector()

std::vector< double > IHistogram::getDataVector ( IHistogram::DataType  dataType ) const

protectedinherited

returns vector of values of requested DataType

Definition at line 311 of file IHistogram.cpp.

{
    std::vector<double> result;
    result.resize(getTotalNumberOfBins(), 0.0);
    for (size_t index = 0; index < getTotalNumberOfBins(); ++index) {
        result[index] = getBinData(index, dataType);
    }
    return result;
}

References IHistogram::getBinData(), and IHistogram::getTotalNumberOfBins().

Referenced by getBinErrors(), and getBinValues().

Here is the call graph for this function:

copyContentFrom()

void IHistogram::copyContentFrom ( const IHistogram &  other )

protectedinherited

Copy content (but not the axes) from other histogram. Dimensions should be the same.

Definition at line 322 of file IHistogram.cpp.

{
    if (!hasSameDimensions(other))
        throw Exceptions::LogicErrorException(
            "IHistogram::copyContentFrom() -> Error. Can't copy the data of different shape.");
    reset();
    for (size_t i = 0; i < getTotalNumberOfBins(); ++i) {
        m_data[i] = other.m_data[i];
    }
}

References IHistogram::getTotalNumberOfBins(), IHistogram::hasSameDimensions(), IHistogram::m_data, and IHistogram::reset().

Referenced by IHistogram::load().

Here is the call graph for this function:

Member Data Documentation

m_data

OutputData<CumulativeValue> IHistogram::m_data

protectedinherited

Definition at line 193 of file IHistogram.h.

Referenced by IHistogram::addBinContent(), Histogram2D::addContent(), IHistogram::copyContentFrom(), IHistogram::createOutputData(), crop(), Histogram2D::crop(), fill(), Histogram2D::fill(), IHistogram::findGlobalBin(), IHistogram::getBinAverage(), IHistogram::getBinContent(), IHistogram::getBinError(), IHistogram::getBinNumberOfEntries(), IHistogram::getData(), IHistogram::getGlobalBin(), IHistogram::getMaximum(), IHistogram::getMaximumBinIndex(), IHistogram::getMinimum(), IHistogram::getMinimumBinIndex(), IHistogram::getTotalNumberOfBins(), IHistogram::getXaxis(), IHistogram::getXaxisIndex(), IHistogram::getXaxisValue(), IHistogram::getYaxis(), IHistogram::getYaxisIndex(), IHistogram::getYaxisValue(), IHistogram::hasSameDimensions(), IHistogram::hasSameShape(), Histogram1D(), Histogram2D::Histogram2D(), IHistogram::IHistogram(), IHistogram::init_from_data(), Histogram2D::initFromShape(), IHistogram::integral(), IHistogram::reset(), IHistogram::scale(), and IHistogram::setBinContent().

---

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

• /home/www/ba/Device/Histo/Histogram1D.h
• /home/www/ba/Device/Histo/Histogram1D.cpp