Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
ROOT::Experimental::RAxisIrregular Class Reference

An axis with non-equidistant bins (also known as "variable binning").

It is defined by an array of bin borders - one more than the number of (non-overflow-) bins it has! As an example, an axis with two bin needs three bin borders:

  • lower edge of the first bin;
  • higher edge of the first bin, identical to the lower edge of the second bin;
  • higher edge of the second bin

This axis cannot grow; the size of new bins would not be well defined.

Definition at line 595 of file RAxis.hxx.

Public Member Functions

 RAxisIrregular ()=default
 
 RAxisIrregular (const std::vector< double > &binborders)
 Construct a RAxisIrregular from a vector of bin borders.
 
 RAxisIrregular (std::string_view title, const std::vector< double > &binborders)
 Construct a RAxisIrregular from a vector of bin borders.
 
 RAxisIrregular (std::string_view title, std::vector< double > &&binborders) noexcept
 Construct a RAxisIrregular from a vector of bin borders.
 
 RAxisIrregular (std::vector< double > &&binborders) noexcept
 Construct a RAxisIrregular from a vector of bin borders.
 
bool CanGrow () const noexcept final
 This axis cannot be extended.
 
int FindBin (double x) const noexcept final
 Find the bin index (adjusted with under- and overflow) for the given coordinate x.
 
const std::vector< double > & GetBinBorders () const noexcept
 Access to the bin borders used by this axis.
 
double GetBinCenter (int bin) const final
 Get the bin center of the bin with the given index.
 
double GetBinFrom (int bin) const final
 Get the lower bin border for a given bin index.
 
int GetBinIndexForLowEdge (double x) const noexcept final
 If the coordinate x is within 10 ULPs of a bin low edge coordinate, return the bin for which this is a low edge.
 
int GetNBinsNoOver () const noexcept final
 Get the number of bins, excluding under- and overflow.
 
 operator RAxisConfig () const
 Convert to RAxisConfig.
 
- Public Member Functions inherited from ROOT::Experimental::RAxisBase
double GetBinTo (int bin) const
 Get the high bin border ("right edge") for the given bin index.
 
int GetFirstBin () const noexcept
 Get the bin index for the first bin of the axis.
 
int GetLastBin () const noexcept
 Get the bin index for the last bin of the axis.
 
double GetMaximum () const
 Get the high end of the axis range.
 
double GetMinimum () const
 Get the low end of the axis range.
 
int GetNBins () const noexcept
 Get the number of bins, including under- and overflow.
 
int GetNOverflowBins () const noexcept
 Get the number of over- and underflow bins: 0 for growable axes, 2 otherwise.
 
int GetOverflowBin () const noexcept
 Get the bin index for the overflow bin (or kInvalidBin if CanGrow()).
 
const std::string & GetTitle () const
 Get the axis's title.
 
int GetUnderflowBin () const noexcept
 Get the bin index for the underflow bin (or kInvalidBin if CanGrow()).
 
bool HasSameBinningAs (const RAxisBase &other) const
 Check if two axes use the same binning convention, i.e.
 
const_iterator begin () const noexcept
 Get a const_iterator pointing to the first regular bin.
 
const_iterator end () const noexcept
 Get a const_iterator pointing beyond the last regular bin.
 

Protected Member Functions

double FindBinRaw (double x) const noexcept
 Find the raw bin index (not adjusted) for the given coordinate x.
 
bool HasSameBinBordersAs (const RAxisBase &other) const override
 See RAxisBase::HasSameBinBordersAs.
 
- Protected Member Functions inherited from ROOT::Experimental::RAxisBase
 RAxisBase () noexcept(noexcept(std::string()))=default
 Default construct a RAxisBase (for use by derived classes for I/O)
 
 RAxisBase (std::string_view title) noexcept
 Construct a RAxisBase.
 
virtual ~RAxisBase ()
 Virtual destructor needed in this inheritance-based design.
 
int AdjustOverflowBinNumber (double rawbin) const
 Given rawbin (<0 for underflow, >=GetNBinsNoOver() for overflow), determine the bin number taking into account how over/underflow should be handled.
 
 RAxisBase (const RAxisBase &)=default
 
 RAxisBase (RAxisBase &&)=default
 
RAxisBaseoperator= (const RAxisBase &)=default
 
RAxisBaseoperator= (RAxisBase &&)=default
 

Private Attributes

std::vector< doublefBinBorders
 Bin borders, one more than the number of regular bins.
 

Additional Inherited Members

- Static Public Attributes inherited from ROOT::Experimental::RAxisBase
static constexpr const int kInvalidBin = 0
 Special bin index returned to signify that no bin matches a request.
 
static constexpr const int kOverflowBin = -2
 Index of the overflow bin, if any.
 
static constexpr const int kUnderflowBin = -1
 Index of the underflow bin, if any.
 

#include <ROOT/RAxis.hxx>

Inheritance diagram for ROOT::Experimental::RAxisIrregular:
[legend]

Constructor & Destructor Documentation

◆ RAxisIrregular() [1/5]

ROOT::Experimental::RAxisIrregular::RAxisIrregular ( )
default

◆ RAxisIrregular() [2/5]

ROOT::Experimental::RAxisIrregular::RAxisIrregular ( const std::vector< double > &  binborders)
inlineexplicit

Construct a RAxisIrregular from a vector of bin borders.

Note
The bin borders must be sorted in increasing order!

Definition at line 622 of file RAxis.hxx.

◆ RAxisIrregular() [3/5]

ROOT::Experimental::RAxisIrregular::RAxisIrregular ( std::vector< double > &&  binborders)
inlineexplicitnoexcept

Construct a RAxisIrregular from a vector of bin borders.

Note
The bin borders must be sorted in increasing order! Faster, noexcept version taking an rvalue of binborders. The compiler will know when it can take this one.

Definition at line 635 of file RAxis.hxx.

◆ RAxisIrregular() [4/5]

ROOT::Experimental::RAxisIrregular::RAxisIrregular ( std::string_view  title,
const std::vector< double > &  binborders 
)
inlineexplicit

Construct a RAxisIrregular from a vector of bin borders.

Note
The bin borders must be sorted in increasing order!

Definition at line 646 of file RAxis.hxx.

◆ RAxisIrregular() [5/5]

ROOT::Experimental::RAxisIrregular::RAxisIrregular ( std::string_view  title,
std::vector< double > &&  binborders 
)
inlineexplicitnoexcept

Construct a RAxisIrregular from a vector of bin borders.

Note
The bin borders must be sorted in increasing order! Faster, noexcept version taking an rvalue of binborders. The compiler will know when it can take this one.

Definition at line 659 of file RAxis.hxx.

Member Function Documentation

◆ CanGrow()

bool ROOT::Experimental::RAxisIrregular::CanGrow ( ) const
inlinefinalvirtualnoexcept

This axis cannot be extended.

Implements ROOT::Experimental::RAxisBase.

Definition at line 708 of file RAxis.hxx.

◆ FindBin()

int ROOT::Experimental::RAxisIrregular::FindBin ( double  x) const
inlinefinalvirtualnoexcept

Find the bin index (adjusted with under- and overflow) for the given coordinate x.

Note
Passing a bin border coordinate can either return the bin above or below the bin border. I.e. don't do that for reliable results!

Implements ROOT::Experimental::RAxisBase.

Definition at line 677 of file RAxis.hxx.

◆ FindBinRaw()

double ROOT::Experimental::RAxisIrregular::FindBinRaw ( double  x) const
inlineprotectednoexcept

Find the raw bin index (not adjusted) for the given coordinate x.

The resulting raw bin is 1-based.

Note
Passing a bin border coordinate can either return the bin above or below the bin border. I.e. don't do that for reliable results!

Definition at line 608 of file RAxis.hxx.

◆ GetBinBorders()

const std::vector< double > & ROOT::Experimental::RAxisIrregular::GetBinBorders ( ) const
inlinenoexcept

Access to the bin borders used by this axis.

Definition at line 711 of file RAxis.hxx.

◆ GetBinCenter()

double ROOT::Experimental::RAxisIrregular::GetBinCenter ( int  bin) const
inlinefinalvirtual

Get the bin center of the bin with the given index.

The result of this method on an overflow or underflow bin is unspecified.

Implements ROOT::Experimental::RAxisBase.

Definition at line 691 of file RAxis.hxx.

◆ GetBinFrom()

double ROOT::Experimental::RAxisIrregular::GetBinFrom ( int  bin) const
inlinefinalvirtual

Get the lower bin border for a given bin index.

The result of this method on an underflow bin is unspecified.

Implements ROOT::Experimental::RAxisBase.

Definition at line 695 of file RAxis.hxx.

◆ GetBinIndexForLowEdge()

int ROOT::Experimental::RAxisIrregular::GetBinIndexForLowEdge ( double  x) const
finalvirtualnoexcept

If the coordinate x is within 10 ULPs of a bin low edge coordinate, return the bin for which this is a low edge.

If it's not a bin edge, return kInvalidBin.

Implements ROOT::Experimental::RAxisBase.

Definition at line 91 of file RAxis.cxx.

◆ GetNBinsNoOver()

int ROOT::Experimental::RAxisIrregular::GetNBinsNoOver ( ) const
inlinefinalvirtualnoexcept

Get the number of bins, excluding under- and overflow.

Implements ROOT::Experimental::RAxisBase.

Definition at line 672 of file RAxis.hxx.

◆ HasSameBinBordersAs()

bool ROOT::Experimental::RAxisIrregular::HasSameBinBordersAs ( const RAxisBase other) const
overrideprotectedvirtual

See RAxisBase::HasSameBinBordersAs.

Reimplemented from ROOT::Experimental::RAxisBase.

Definition at line 114 of file RAxis.cxx.

◆ operator RAxisConfig()

ROOT::Experimental::RAxisIrregular::operator RAxisConfig ( ) const
inline

Convert to RAxisConfig.

Definition at line 669 of file RAxis.hxx.

Member Data Documentation

◆ fBinBorders

std::vector<double> ROOT::Experimental::RAxisIrregular::fBinBorders
private

Bin borders, one more than the number of regular bins.

Definition at line 598 of file RAxis.hxx.

Libraries for ROOT::Experimental::RAxisIrregular:

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