ConstKBinAxis Class Reference

Inheritance diagram for ConstKBinAxis:

Collaboration diagram for ConstKBinAxis:

Public Member Functions
	ConstKBinAxis (const std::string &name, size_t nbins, double start, double end)
	~ConstKBinAxis () final
ConstKBinAxis *	clone () const final
ConstKBinAxis *	createClippedAxis (double left, double right) const final
size_t	size () const
double	operator[] (size_t index) const
Bin1D	getBin (size_t index) const
double	getMin () const
double	getMax () const
double	getBinCenter (size_t index) const
size_t	findClosestIndex (double value) const
std::vector< double >	getBinCenters () const
std::vector< double >	getBinBoundaries () const
std::string	pyString (const std::string &units, size_t offset) const final
std::string	getName () const
void	setName (std::string name)
bool	operator== (const IAxis &right) const
bool	operator!= (const IAxis &right) const
virtual bool	contains (double value) const

Protected Member Functions
	ConstKBinAxis (const std::string &name, size_t nbins)
void	print (std::ostream &ostr) const final
bool	equals (const IAxis &other) const final
void	setBinBoundaries (const std::vector< double > &bin_boundaries)

Protected Attributes
double	m_start
double	m_end
size_t	m_nbins

Private Attributes
std::vector< double >	m_bin_boundaries
std::string	m_name

Detailed Description

Axis with fixed bin size in sin(angle) space.

Definition at line 23 of file ConstKBinAxis.h.

Constructor & Destructor Documentation

ConstKBinAxis() [1/2]

ConstKBinAxis::ConstKBinAxis	(	const std::string &	name,
		size_t	nbins,
		double	start,
		double	end
	)

ConstKBinAxis constructor.

Parameters

name	Axis name
nbins	number of bins
start	low edge of first bin
end	upper edge of last bin

Definition at line 25 of file ConstKBinAxis.cpp.

    : VariableBinAxis(name, nbins), m_start(start), m_end(end)
{
    if (m_start >= m_end)
        throw Exceptions::LogicErrorException(
            "ConstKBinAxis::ConstKBinAxis() -> Error. start >= end is not allowed.");
 
    double start_sin = std::sin(m_start);
    double end_sin = std::sin(m_end);
    double step = (end_sin - start_sin) / (m_nbins);
 
    std::vector<double> bin_boundaries;
    bin_boundaries.resize(m_nbins + 1, 0.0);
    for (size_t i = 0; i < bin_boundaries.size(); ++i) {
        bin_boundaries[i] = std::asin(start_sin + step * i);
    }
    setBinBoundaries(bin_boundaries);
}

References m_end, VariableBinAxis::m_nbins, m_start, and VariableBinAxis::setBinBoundaries().

Referenced by clone(), and createClippedAxis().

Here is the call graph for this function:

~ConstKBinAxis()

ConstKBinAxis::~ConstKBinAxis ( )

inlinefinal

Definition at line 32 of file ConstKBinAxis.h.

{}

ConstKBinAxis() [2/2]

ConstKBinAxis::ConstKBinAxis ( const std::string &  name, size_t  nbins  )

protected

Definition at line 20 of file ConstKBinAxis.cpp.

    : VariableBinAxis(name, nbins), m_start(0), m_end(0)
{
}

Member Function Documentation

clone()

ConstKBinAxis * ConstKBinAxis::clone ( ) const

finalvirtual

clone function

Implements IAxis.

Definition at line 44 of file ConstKBinAxis.cpp.

{
    return new ConstKBinAxis(getName(), m_nbins, m_start, m_end);
}

References ConstKBinAxis(), IAxis::getName(), m_end, VariableBinAxis::m_nbins, and m_start.

Here is the call graph for this function:

createClippedAxis()

ConstKBinAxis * ConstKBinAxis::createClippedAxis ( double  left, double  right  ) const

finalvirtual

Creates a new clipped axis.

Reimplemented from VariableBinAxis.

Definition at line 49 of file ConstKBinAxis.cpp.

{
    if (left >= right)
        throw Exceptions::LogicErrorException(
            "ConstKBinAxis::createClippedAxis() -> Error. 'left'' should be smaller than 'right'");
 
    if (left < getMin())
        left = getBin(0).getMidPoint();
    if (right >= getMax())
        right = getBin(size() - 1).getMidPoint();
 
    size_t nbin1 = findClosestIndex(left);
    size_t nbin2 = findClosestIndex(right);
 
    size_t new_nbins = nbin2 - nbin1 + 1;
    std::vector<double> new_boundaries;
    std::vector<double> old_boundaries = getBinBoundaries();
    for (size_t i = 0; i < new_nbins + 1; ++i) {
        new_boundaries.push_back(old_boundaries[nbin1 + i]);
    }
 
    ConstKBinAxis* result = new ConstKBinAxis(getName(), new_nbins);
    result->m_start = new_boundaries.front();
    result->m_end = new_boundaries.back();
    result->setBinBoundaries(new_boundaries);
    return result;
}

References ConstKBinAxis(), VariableBinAxis::findClosestIndex(), VariableBinAxis::getBin(), VariableBinAxis::getBinBoundaries(), VariableBinAxis::getMax(), Bin1D::getMidPoint(), VariableBinAxis::getMin(), IAxis::getName(), m_end, m_start, VariableBinAxis::setBinBoundaries(), and VariableBinAxis::size().

Here is the call graph for this function:

print()

void ConstKBinAxis::print ( std::ostream &  ostr ) const

finalprotectedvirtual

Reimplemented from VariableBinAxis.

Definition at line 93 of file ConstKBinAxis.cpp.

{
    ostr << "ConstKBinAxis(\"" << getName() << "\", " << size() << ", "
         << std::setprecision(std::numeric_limits<double>::digits10 + 2) << m_start << ", " << m_end
         << ")";
}

References IAxis::getName(), m_end, m_start, and VariableBinAxis::size().

Here is the call graph for this function:

equals()

bool ConstKBinAxis::equals ( const IAxis &  other ) const

finalprotectedvirtual

Reimplemented from VariableBinAxis.

Definition at line 77 of file ConstKBinAxis.cpp.

{
    if (!IAxis::equals(other))
        return false;
    if (const ConstKBinAxis* otherAxis = dynamic_cast<const ConstKBinAxis*>(&other)) {
        if (size() != otherAxis->size())
            return false;
        if (!algo::almostEqual(m_start, otherAxis->m_start))
            return false;
        if (!algo::almostEqual(m_end, otherAxis->m_end))
            return false;
        return true;
    }
    return false;
}

References algo::almostEqual(), IAxis::equals(), m_end, m_start, and VariableBinAxis::size().

Here is the call graph for this function:

size()

size_t VariableBinAxis::size ( ) const

inlinevirtualinherited

retrieve the number of bins

Implements IAxis.

Definition at line 37 of file VariableBinAxis.h.

{ return m_nbins; }

References VariableBinAxis::m_nbins.

Referenced by VariableBinAxis::createClippedAxis(), createClippedAxis(), CustomBinAxis::equals(), VariableBinAxis::equals(), equals(), VariableBinAxis::getBinCenters(), CustomBinAxis::print(), VariableBinAxis::print(), and print().

operator[]()

double VariableBinAxis::operator[] ( size_t  index ) const

virtualinherited

indexed accessor retrieves a sample

Implements IAxis.

Definition at line 44 of file VariableBinAxis.cpp.

{
    return getBin(index).getMidPoint();
}

References VariableBinAxis::getBin(), and Bin1D::getMidPoint().

Here is the call graph for this function:

getBin()

Bin1D VariableBinAxis::getBin ( size_t  index ) const

virtualinherited

retrieve a 1d bin for the given index

Implements IAxis.

Definition at line 49 of file VariableBinAxis.cpp.

{
    if (index >= m_nbins)
        throw Exceptions::OutOfBoundsException("VariableBinAxis::getBin() -> Error. Wrong index.");
 
    Bin1D result(m_bin_boundaries[index], m_bin_boundaries[index + 1]);
    return result;
}

References VariableBinAxis::m_bin_boundaries, and VariableBinAxis::m_nbins.

Referenced by VariableBinAxis::createClippedAxis(), createClippedAxis(), VariableBinAxis::getBinCenter(), VariableBinAxis::getBinCenters(), and VariableBinAxis::operator[]().

getMin()

double VariableBinAxis::getMin ( ) const

virtualinherited

Returns value of first point of axis.

Implements IAxis.

Definition at line 58 of file VariableBinAxis.cpp.

{
    return m_bin_boundaries.front();
}

References VariableBinAxis::m_bin_boundaries.

Referenced by VariableBinAxis::createClippedAxis(), createClippedAxis(), and VariableBinAxis::findClosestIndex().

getMax()

double VariableBinAxis::getMax ( ) const

virtualinherited

Returns value of last point of axis.

Implements IAxis.

Definition at line 63 of file VariableBinAxis.cpp.

{
    return m_bin_boundaries.back();
}

References VariableBinAxis::m_bin_boundaries.

Referenced by VariableBinAxis::createClippedAxis(), createClippedAxis(), and VariableBinAxis::findClosestIndex().

getBinCenter()

double VariableBinAxis::getBinCenter ( size_t  index ) const

virtualinherited

Implements IAxis.

Definition at line 68 of file VariableBinAxis.cpp.

{
    return getBin(index).getMidPoint();
}

References VariableBinAxis::getBin(), and Bin1D::getMidPoint().

Here is the call graph for this function:

findClosestIndex()

size_t VariableBinAxis::findClosestIndex ( double  value ) const

virtualinherited

find bin index which is best match for given value

Implements IAxis.

Definition at line 73 of file VariableBinAxis.cpp.

{
    if (m_bin_boundaries.size() < 2)
        throw Exceptions::ClassInitializationException(
            "VariableBinAxis::findClosestIndex() -> Error! "
            "VariableBinAxis not  correctly initialized");
    if (value < getMin()) {
        return 0;
    } else if (value >= getMax()) {
        return m_nbins - 1;
    }
 
    std::vector<double>::const_iterator top_limit =
        std::lower_bound(m_bin_boundaries.begin(), m_bin_boundaries.end(), value);
    if (*top_limit != value)
        --top_limit;
    size_t nbin = top_limit - m_bin_boundaries.begin();
    return nbin;
}

References VariableBinAxis::getMax(), VariableBinAxis::getMin(), VariableBinAxis::m_bin_boundaries, and VariableBinAxis::m_nbins.

Referenced by VariableBinAxis::createClippedAxis(), and createClippedAxis().

Here is the call graph for this function:

getBinCenters()

std::vector< double > VariableBinAxis::getBinCenters ( ) const

virtualinherited

Reimplemented from IAxis.

Definition at line 93 of file VariableBinAxis.cpp.

{
    std::vector<double> result;
    result.resize(size(), 0.0);
    for (size_t i = 0; i < size(); ++i) {
        result[i] = getBin(i).getMidPoint();
    }
    return result;
}

References VariableBinAxis::getBin(), Bin1D::getMidPoint(), and VariableBinAxis::size().

Here is the call graph for this function:

getBinBoundaries()

std::vector<double> VariableBinAxis::getBinBoundaries ( ) const

inlinevirtualinherited

Reimplemented from IAxis.

Definition at line 51 of file VariableBinAxis.h.

{ return m_bin_boundaries; }

References VariableBinAxis::m_bin_boundaries.

Referenced by createClippedAxis().

pyString()

std::string VariableBinAxis::pyString ( const std::string &  units, size_t  offset  ) const

finalvirtualinherited

Implements IAxis.

Definition at line 127 of file VariableBinAxis.cpp.

{
    throw std::runtime_error("VariableBinAxis::pyString not yet implemented"); // TODO
}

setBinBoundaries()

void VariableBinAxis::setBinBoundaries ( const std::vector< double > &  bin_boundaries )

protectedinherited

Definition at line 160 of file VariableBinAxis.cpp.

{
    // checking that values are sorted
    std::vector<double> vec_sorted = bin_boundaries;
    std::sort(vec_sorted.begin(), vec_sorted.end());
    for (size_t i = 0; i < bin_boundaries.size(); ++i) {
        if (vec_sorted[i] != bin_boundaries[i])
            throw Exceptions::LogicErrorException("VariableBinAxis::VariableBinAxis() -> Error. "
                                                  "Array with bin edges is not sorted.");
    }
 
    std::vector<double> vec = bin_boundaries;
    vec.erase(std::unique(vec.begin(), vec.end()), vec.end());
 
    if (vec.size() != bin_boundaries.size())
        throw Exceptions::LogicErrorException("VariableBinAxis::VariableBinAxis() -> Error. "
                                              "Array with bin edges contains repeating values.");
 
    m_bin_boundaries = bin_boundaries;
}

References VariableBinAxis::m_bin_boundaries.

Referenced by ConstKBinAxis(), createClippedAxis(), CustomBinAxis::CustomBinAxis(), and VariableBinAxis::VariableBinAxis().

getName()

std::string IAxis::getName ( ) const

inlineinherited

retrieve the label of the axis

Definition at line 40 of file IAxis.h.

{ return m_name; }

References IAxis::m_name.

Referenced by OutputData< T >::addAxis(), RegionOfInterest::clipAxisToRoi(), CustomBinAxis::clone(), FixedBinAxis::clone(), VariableBinAxis::clone(), clone(), PointwiseAxis::clone(), FixedBinAxis::createClippedAxis(), VariableBinAxis::createClippedAxis(), createClippedAxis(), PointwiseAxis::createClippedAxis(), IAxis::equals(), CustomBinAxis::print(), FixedBinAxis::print(), VariableBinAxis::print(), print(), PointwiseAxis::print(), and FixedBinAxis::pyString().

setName()

void IAxis::setName ( std::string  name )

inlineinherited

Sets the axis label.

Definition at line 43 of file IAxis.h.

{ m_name = name; }

References IAxis::m_name.

operator==()

bool IAxis::operator== ( const IAxis &  right ) const

inlineinherited

test for equality

Definition at line 63 of file IAxis.h.

{ return equals(right); }

References IAxis::equals().

Here is the call graph for this function:

operator!=()

bool IAxis::operator!= ( const IAxis &  right ) const

inlineinherited

Definition at line 64 of file IAxis.h.

{ return !(*this == right); }

contains()

bool IAxis::contains ( double  value ) const

virtualinherited

Returns true if axis contains given point.

Definition at line 40 of file IAxis.cpp.

{
    return value >= getMin() && value < getMax();
}

References IAxis::getMax(), and IAxis::getMin().

Referenced by Histogram1D::crop(), Histogram2D::crop(), RectangularDetector::indexOfSpecular(), and SphericalDetector::indexOfSpecular().

Here is the call graph for this function:

Member Data Documentation

m_start

double ConstKBinAxis::m_start

protected

Definition at line 44 of file ConstKBinAxis.h.

Referenced by clone(), ConstKBinAxis(), createClippedAxis(), equals(), and print().

m_end

double ConstKBinAxis::m_end

protected

Definition at line 45 of file ConstKBinAxis.h.

Referenced by clone(), ConstKBinAxis(), createClippedAxis(), equals(), and print().

m_nbins

size_t VariableBinAxis::m_nbins

protectedinherited

Definition at line 63 of file VariableBinAxis.h.

Referenced by CustomBinAxis::clone(), VariableBinAxis::clone(), clone(), ConstKBinAxis(), CustomBinAxis::CustomBinAxis(), VariableBinAxis::findClosestIndex(), CustomBinAxis::getBin(), VariableBinAxis::getBin(), VariableBinAxis::size(), and VariableBinAxis::VariableBinAxis().

m_bin_boundaries

std::vector<double> VariableBinAxis::m_bin_boundaries

privateinherited

vector containing the bin limits

Definition at line 66 of file VariableBinAxis.h.

Referenced by VariableBinAxis::clone(), VariableBinAxis::createClippedAxis(), VariableBinAxis::equals(), VariableBinAxis::findClosestIndex(), VariableBinAxis::getBin(), VariableBinAxis::getBinBoundaries(), VariableBinAxis::getMax(), VariableBinAxis::getMin(), VariableBinAxis::print(), and VariableBinAxis::setBinBoundaries().

m_name

std::string IAxis::m_name

privateinherited

axis name

Definition at line 92 of file IAxis.h.

Referenced by IAxis::getName(), and IAxis::setName().

---

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

• /home/www/ba/Base/Axis/ConstKBinAxis.h
• /home/www/ba/Base/Axis/ConstKBinAxis.cpp