ROOT::Experimental::RCategoricalAxis Class Reference

An axis with categorical bins.

For example, the following creates an axis with 3 categories:

std::vector<std::string> categories = {"a", "b", "c"};
ROOT::Experimental::RCategoricalAxis axis(categories);

It is possible to disable the overflow bin by passing enableOverflowBin = false. In that case, arguments outside the axis will be silently discarded.

Warning

This is part of the ROOT 7 prototype! It will change without notice. It might trigger earthquakes. Feedback is welcome!

Definition at line 43 of file RCategoricalAxis.hxx.

Public Types
using	ArgumentType = std::string_view

Public Member Functions
	RCategoricalAxis (std::vector< std::string > categories, bool enableOverflowBin=true)
	Construct an axis object with categories.
RLinearizedIndex	ComputeLinearizedIndex (std::string_view x) const
	Compute the linarized index for a single argument.
const std::vector< std::string > &	GetCategories () const
RBinIndexRange	GetFullRange () const
	Get the full range of all bins.
RLinearizedIndex	GetLinearizedIndex (RBinIndex index) const
	Get the linearized index for an RBinIndex.
std::uint64_t	GetNNormalBins () const
RBinIndexRange	GetNormalRange () const
	Get the range of all normal bins.
RBinIndexRange	GetNormalRange (RBinIndex begin, RBinIndex end) const
	Get a range of normal bins.
std::uint64_t	GetTotalNBins () const
bool	HasOverflowBin () const
RCategoricalAxis	Slice (const RSliceSpec &sliceSpec) const
	Slice this axis according to the specification.
void	Streamer (TBuffer &)
	ROOT Streamer function to throw when trying to store an object of this class.

Private Attributes
std::vector< std::string >	fCategories
	The categories as defined by the user.
bool	fEnableOverflowBin
	Whether the overflow bin is enabled.

Friends
bool	operator== (const RCategoricalAxis &lhs, const RCategoricalAxis &rhs)

#include <ROOT/RCategoricalAxis.hxx>

Member Typedef Documentation

ArgumentType

using ROOT::Experimental::RCategoricalAxis::ArgumentType = std::string_view

Definition at line 45 of file RCategoricalAxis.hxx.

Constructor & Destructor Documentation

RCategoricalAxis()

ROOT::Experimental::RCategoricalAxis::RCategoricalAxis ( std::vector< std::string > categories, bool enableOverflowBin = true )

inlineexplicit

Construct an axis object with categories.

Parameters

[in]	categories	the categories without duplicates, must define at least one bin (i.e. size >= 1)
[in]	enableOverflowBin	whether to enable the overflow bin

Definition at line 58 of file RCategoricalAxis.hxx.

Member Function Documentation

ComputeLinearizedIndex()

RLinearizedIndex ROOT::Experimental::RCategoricalAxis::ComputeLinearizedIndex ( std::string_view x ) const

inline

Compute the linarized index for a single argument.

The normal bins have indices \(0\) to \(fCategories.size() - 1\) and the overflow bin has index \(fCategories.size()\). If the argument is not a recognized category and the overflow bin is disabled, the return value is invalid.

Parameters

[in]

x

the argument

Returns

the linearized index that may be invalid

Definition at line 92 of file RCategoricalAxis.hxx.

GetCategories()

const std::vector< std::string > & ROOT::Experimental::RCategoricalAxis::GetCategories ( ) const

inline

Definition at line 76 of file RCategoricalAxis.hxx.

GetFullRange()

RBinIndexRange ROOT::Experimental::RCategoricalAxis::GetFullRange ( ) const

inline

Get the full range of all bins.

This includes the overflow bin, if enabled.

Returns

the bin index range of all bins

Definition at line 165 of file RCategoricalAxis.hxx.

GetLinearizedIndex()

RLinearizedIndex ROOT::Experimental::RCategoricalAxis::GetLinearizedIndex ( RBinIndex index ) const

inline

Get the linearized index for an RBinIndex.

The normal bins have indices \(0\) to \(fCategories.size() - 1\) and the overflow bin has index \(fCategories.size()\).

Parameters

[in]

index

the RBinIndex

Returns

the linearized index that may be invalid

Definition at line 112 of file RCategoricalAxis.hxx.

GetNNormalBins()

std::uint64_t ROOT::Experimental::RCategoricalAxis::GetNNormalBins ( ) const

inline

Definition at line 74 of file RCategoricalAxis.hxx.

GetNormalRange() [1/2]

RBinIndexRange ROOT::Experimental::RCategoricalAxis::GetNormalRange ( ) const

inline

Get the range of all normal bins.

Returns

the bin index range from the first to the last normal bin, inclusive

Definition at line 130 of file RCategoricalAxis.hxx.

GetNormalRange() [2/2]

RBinIndexRange ROOT::Experimental::RCategoricalAxis::GetNormalRange ( RBinIndex begin, RBinIndex end ) const

inline

Get a range of normal bins.

Parameters

[in]	begin	the begin of the bin index range (inclusive), must be normal
[in]	end	the end of the bin index range (exclusive), must be normal and >= begin

Returns

a bin index range \([begin, end)\)

Definition at line 140 of file RCategoricalAxis.hxx.

GetTotalNBins()

std::uint64_t ROOT::Experimental::RCategoricalAxis::GetTotalNBins ( ) const

inline

Definition at line 75 of file RCategoricalAxis.hxx.

HasOverflowBin()

bool ROOT::Experimental::RCategoricalAxis::HasOverflowBin ( ) const

inline

Definition at line 77 of file RCategoricalAxis.hxx.

Slice()

RCategoricalAxis ROOT::Experimental::RCategoricalAxis::Slice ( const RSliceSpec & sliceSpec ) const

inline

Slice this axis according to the specification.

A categorical axis cannot be sliced. The method will throw if a specification other than the default slice operation is passed.

Parameters

[in]

sliceSpec

the slice specification

Returns

the sliced / copied axis

Definition at line 178 of file RCategoricalAxis.hxx.

Streamer()

void ROOT::Experimental::RCategoricalAxis::Streamer ( TBuffer & )

inline

ROOT Streamer function to throw when trying to store an object of this class.

Definition at line 197 of file RCategoricalAxis.hxx.

Friends And Related Symbol Documentation

operator==

bool operator== ( const RCategoricalAxis & lhs, const RCategoricalAxis & rhs )

friend

Definition at line 79 of file RCategoricalAxis.hxx.

Member Data Documentation

fCategories

std::vector<std::string> ROOT::Experimental::RCategoricalAxis::fCategories

private

The categories as defined by the user.

Definition at line 49 of file RCategoricalAxis.hxx.

fEnableOverflowBin

bool ROOT::Experimental::RCategoricalAxis::fEnableOverflowBin

private

Whether the overflow bin is enabled.

Definition at line 51 of file RCategoricalAxis.hxx.

---

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

• hist/histv7/inc/ROOT/RCategoricalAxis.hxx