Namespaces
namespace	GraphDrawing

Classes
class	ArrayPtrVisitor

struct	Disjunction

struct	Disjunction< B1 >

struct	Disjunction< B1, Bn... >

class	DisplayHelper

struct	IsDataContainer
	Check for container traits. More...

struct	IsDataContainer< ROOT::VecOps::RVec< bool > >

struct	IsDataContainer< std::span< T > >

struct	IsDataContainer< std::vector< bool > >

struct	IsRVec

struct	IsRVec< ROOT::VecOps::RVec< T > >

struct	IsVector_t
	Detect whether a type is an instantiation of vector<T,A> More...

struct	IsVector_t< std::vector< T, A > >

class	PassAsVecHelper

class	PassAsVecHelper< std::index_sequence< N... >, T, F >

class	RAction
	A RDataFrame node that produces a result. More...

class	RActionBase

class	RCallback

struct	RColumnReadersInfo
	This type aggregates some of the arguments passed to MakeColumnReaders. More...

class	RColumnRegister
	A binder for user-defined columns and aliases. More...

class	RDefineReader
	Column reader for defined (aka custom) columns. More...

class	RDisplayElement
	Helper class to let Display print compact tabular representations of the events. More...

class	RDSColumnReader
	Column reader type that deals with values read from RDataSources. More...

struct	RemoveFirstParameterIf
	`type` is TypeList if MustRemove is false, otherwise it is a TypeList with the first type removed More...

struct	RemoveFirstParameterIf< true, TypeList >

struct	RemoveFirstTwoParametersIf

struct	RemoveFirstTwoParametersIf< true, TypeList >

class	RJittedAction

class	RJittedVariation
	A wrapper around a concrete RVariation, which forwards all calls to it RJittedVariation is a placeholder that is inserted in the computation graph in place of a RVariation that will be just-in-time compiled. More...

struct	RNewSampleFlag

class	RNewSampleNotifier

class	RNumpyDS
	A RDataSource implementation which takes a collection of RVecs, which are able to adopt data from Numpy arrays. More...

class	ROneTimeCallback

struct	RootConversionTraits

class	RRootDS
	This class is unused and it has only been implemented as a proof of concept. More...

class	RSlotStack
	This is an helper class to allow to pick a slot resorting to a map indexed by thread ids. More...

class	RTreeColumnReader
	RTreeColumnReader specialization for TTree values read via TTreeReaderValues. More...

class	RTreeColumnReader< RVec< bool > >
	RTreeColumnReader specialization for arrays of boolean values read via TTreeReaderArrays. More...

class	RTreeColumnReader< RVec< T > >
	RTreeColumnReader specialization for TTree values read via TTreeReaderArrays. More...

class	RVariation

class	RVariationBase
	This type includes all parts of RVariation that do not depend on the callable signature. More...

class	RVariationReader
	Column reader that reads the value for a specific column, variation and slot. More...

class	RVariedAction
	Just like an RAction, but it has N action helpers (one per variation + nominal) and N previous nodes. More...

class	TValueGetter
	Helper class which keeps track for each slot where to get the entry. More...

struct	ValueType

struct	ValueType< ROOT::VecOps::RVec< T >, false >

struct	ValueType< T, false >

Typedefs
using	Callback_t = std::function< void(unsigned int)>

template<bool MustRemove, typename TypeList >
using	RemoveFirstParameterIf_t = typename RemoveFirstParameterIf< MustRemove, TypeList >::type

template<bool MustRemove, typename TypeList >
using	RemoveFirstTwoParametersIf_t = typename RemoveFirstTwoParametersIf< MustRemove, TypeList >::type

Functions
std::pair< std::vector< std::string >, std::vector< std::string > >	AddSizeBranches (const std::vector< std::string > &branches, TTree *tree, std::vector< std::string > &&colsWithoutAliases, std::vector< std::string > &&colsWithAliases)
	Return copies of colsWithoutAliases and colsWithAliases with size branches for variable-sized array branches added in the right positions (i.e.

template<typename T >
std::enable_if_t< IsRVec< T >::value, void >	AssignResults (ROOT::RVec< T > &resStorage, ROOT::RVec< T > &&tmpResults, std::size_t nCols)

template<typename T >
std::enable_if_t<!IsRVec< T >::value, void >	AssignResults (ROOT::RVec< T > &resStorage, ROOT::RVec< T > &&tmpResults, std::size_t)

bool	AtLeastOneEmptyString (const std::vector< std::string_view > strings)

std::shared_ptr< RJittedDefine >	BookDefineJit (std::string_view name, std::string_view expression, RLoopManager &lm, RDataSource ds, const RColumnRegister &customCols, const ColumnNames_t &branches, std::shared_ptr< RNodeBase > upcastNodeOnHeap)
	Book the jitting of a Define call.

std::shared_ptr< RJittedDefine >	BookDefinePerSampleJit (std::string_view name, std::string_view expression, RLoopManager &lm, const RColumnRegister &customCols, std::shared_ptr< RNodeBase > *upcastNodeOnHeap)
	Book the jitting of a DefinePerSample call.

std::shared_ptr< RDFDetail::RJittedFilter >	BookFilterJit (std::shared_ptr< RDFDetail::RNodeBase > prevNodeOnHeap, std::string_view name, std::string_view expression, const ColumnNames_t &branches, const RColumnRegister &customCols, TTree tree, RDataSource *ds)
	Book the jitting of a Filter call.

std::shared_ptr< RJittedVariation >	BookVariationJit (const std::vector< std::string > &colNames, std::string_view variationName, const std::vector< std::string > &variationTags, std::string_view expression, RLoopManager &lm, RDataSource ds, const RColumnRegister &colRegister, const ColumnNames_t &branches, std::shared_ptr< RNodeBase > upcastNodeOnHeap)
	Book the jitting of a Vary call.

template<typename T >
constexpr std::size_t	CacheLineStep ()
	Stepping through CacheLineStep<T> values in a vector<T> brings you to a new cache line.

void	CheckForDefinition (const std::string &where, std::string_view definedColView, const RColumnRegister &customCols, const ColumnNames_t &treeColumns, const ColumnNames_t &dataSourceColumns)
	Throw if column `definedColView` is not already there.

void	CheckForDuplicateSnapshotColumns (const ColumnNames_t &cols)

void	CheckForNoVariations (const std::string &where, std::string_view definedColView, const RColumnRegister &customCols)
	Throw if the column has systematic variations attached.

void	CheckForRedefinition (const std::string &where, std::string_view definedColView, const RColumnRegister &customCols, const ColumnNames_t &treeColumns, const ColumnNames_t &dataSourceColumns)
	Throw if column `definedColView` is already there.

void	CheckReaderTypeMatches (const std::type_info &colType, const std::type_info &requestedType, const std::string &colName, const std::string &where)

void	CheckTypesAndPars (unsigned int nTemplateParams, unsigned int nColumnNames)

void	CheckValidCppVarName (std::string_view var, const std::string &where)

std::string	ColumnName2ColumnTypeName (const std::string &colName, TTree tree, RDataSource ds, RDefineBase *define, bool vector2rvec)
	Return a string containing the type of the given branch.

std::string	ComposeRVecTypeName (const std::string &valueType)

ColumnNames_t	ConvertRegexToColumns (const ColumnNames_t &colNames, std::string_view columnNameRegexp, std::string_view callerName)

std::string	DemangleTypeIdName (const std::type_info &typeInfo)

template<typename T >
void	Erase (const T &that, std::vector< T > &v)
	Erase `that` element from vector `v`

ColumnNames_t	FilterArraySizeColNames (const ColumnNames_t &columnNames, const std::string &action)
	Take a list of column names, return that list with entries starting by '#' filtered out.

template<typename T >
constexpr std::size_t	FindIdxTrue (const T &arr)

std::vector< bool >	FindUndefinedDSColumns (const ColumnNames_t &requestedCols, const ColumnNames_t &definedCols)
	Return a bitset each element of which indicates whether the corresponding element in `selectedColumns` is the name of a column that must be defined via datasource.

ColumnNames_t	FindUnknownColumns (const ColumnNames_t &requiredCols, const ColumnNames_t &datasetColumns, const RColumnRegister &definedCols, const ColumnNames_t &dataSourceColumns)

ULong64_t	GetAddress (std::vector< std::string > &p)

ULong64_t	GetAddress (TTree &p)

std::vector< std::string >	GetBranchNames (TTree &t, bool allowDuplicates=true)
	Get all the branches names, including the ones of the friend trees.

std::string	GetBranchOrLeafTypeName (TTree &t, const std::string &colName)
	Return the typename of object colName stored in t, if any.

unsigned int	GetColumnWidth (const std::vector< std::string > &names, const unsigned int minColumnSpace=8u)
	Get optimal column width for printing a table given the names and the desired minimal space between columns.

std::vector< std::string >	GetFilterNames (const std::shared_ptr< RLoopManager > &loopManager)

template<typename RVec_t , typename Value_t = typename RVec_t::value_type>
std::enable_if_t< IsRVec< Value_t >::value, const std::type_info & >	GetInnerValueType (std::size_t nCols)

template<typename RVec_t , typename Value_t = typename RVec_t::value_type>
std::enable_if_t<!IsRVec< Value_t >::value, const std::type_info & >	GetInnerValueType (std::size_t)

std::string	GetLeafTypeName (TLeaf *leaf, const std::string &colName)

unsigned int	GetNSlots ()

template<std::size_t N, typename... Ts>
decltype(auto)	GetNthElement (Ts &&...args)

template<typename T >
std::size_t	GetNVariations (const RVec< RVec< T > > &results)

template<typename T >
std::size_t	GetNVariations (const RVec< T > &results)

ColumnNames_t	GetTopLevelBranchNames (TTree &t)
	Get all the top-level branches names, including the ones of the friend trees.

std::vector< std::string >	GetValidatedArgTypes (const ColumnNames_t &colNames, const RColumnRegister &colRegister, TTree tree, RDataSource ds, const std::string &context, bool vector2rvec)

ColumnNames_t	GetValidatedColumnNames (RLoopManager &lm, const unsigned int nColumns, const ColumnNames_t &columns, const RColumnRegister &customColumns, RDataSource *ds)
	Given the desired number of columns and the user-provided list of columns:

template<typename dtype >
ULong64_t	GetVectorAddress (std::vector< dtype > &p)

Long64_t	InterpreterCalc (const std::string &code, const std::string &context="")
	Jit code in the interpreter with TInterpreter::Calc, throw in case of errors.

void	InterpreterDeclare (const std::string &code)
	Declare code in the interpreter via the TInterpreter::Declare method, throw in case of errors.

bool	IsInternalColumn (std::string_view colName)
	Whether custom column with name colName is an "internal" column such as rdfentry_ or rdfslot_.

bool	IsStrInVec (const std::string &str, const std::vector< std::string > &vec)

std::string	JitBuildAction (const ColumnNames_t &cols, std::shared_ptr< RDFDetail::RNodeBase > prevNode, const std::type_info &helperArgType, const std::type_info &at, void helperArgOnHeap, TTree tree, const unsigned int nSlots, const RColumnRegister &customCols, RDataSource ds, std::weak_ptr< RJittedAction > *jittedActionOnHeap)

template<typename T >
std::unique_ptr< RDFDetail::RColumnReaderBase >	MakeColumnReader (unsigned int slot, RDefineBase define, const std::map< std::string, std::vector< void > > &DSValuePtrsMap, TTreeReader r, ROOT::RDF::RDataSource ds, const std::string &colName, RVariationBase *variation, const std::string &variationName)

template<typename... ColTypes>
std::array< std::unique_ptr< RDFDetail::RColumnReaderBase >, sizeof...(ColTypes)>	MakeColumnReaders (unsigned int slot, TTreeReader *r, TypeList< ColTypes... >, const RColumnReadersInfo &colInfo, const std::string &variationName="nominal")
	Create a group of column readers, one per type in the parameter pack.

std::array< std::unique_ptr< RDFDetail::RColumnReaderBase >, 0 >	MakeColumnReaders (unsigned int, TTreeReader *, TypeList<>, const RColumnReadersInfo &, const std::string &="nominal")

ROOT::RDataFrame	MakeDataFrameFromSpec (const RDatasetSpec &spec)

template<typename... ColumnTypes>
RDataFrame *	MakeNumpyDataFrame (PyObject pyRVecs, std::pair< std::string, ROOT::RVec< ColumnTypes > > &&... colNameProxyPairs)

template<typename T >
ROOT::RDF::Experimental::RResultMap< T >	MakeResultMap (std::shared_ptr< T > nominalResult, std::vector< std::shared_ptr< T > > &&variedResults, std::vector< std::string > &&keys, RLoopManager &lm, std::shared_ptr< ROOT::Internal::RDF::RActionBase > nominalAction, std::shared_ptr< ROOT::Internal::RDF::RActionBase > variedAction)

RDataFrame	MakeRootDataFrame (std::string_view treeName, std::string_view fileNameGlob)

template<typename... ArgTypes, typename F >
std::function< bool(ArgTypes...)>	NotHelper (ROOT::TypeTraits::TypeList< ArgTypes... >, F &&f)

template<typename... ArgTypes, typename Ret , typename... Args>
std::function< bool(ArgTypes...)>	NotHelper (ROOT::TypeTraits::TypeList< ArgTypes... >, Ret(*f)(Args...))

ParsedTreePath	ParseTreePath (std::string_view fullTreeName)

template<std::size_t N, typename T , typename F >
auto	PassAsVec (F &&f) -> PassAsVecHelper< std::make_index_sequence< N >, T, F >

std::string	PrettyPrintAddr (const void *const addr)

template<typename T >
ROOT::RDF::RResultPtr< std::vector< T > >	RDataFrameTake (ROOT::RDF::RNode df, std::string_view column)

void	RemoveDuplicates (ColumnNames_t &columnNames)

std::vector< std::string >	ReplaceDotWithUnderscore (const std::vector< std::string > &columnNames)
	Replace occurrences of '.

template<typename T >
std::enable_if_t< IsRVec< T >::value, void >	ResizeResults (ROOT::RVec< T > &results, std::size_t nCols, std::size_t nVariations)

template<typename T >
std::enable_if_t<!IsRVec< T >::value, void >	ResizeResults (ROOT::RVec< T > &results, std::size_t, std::size_t nVariations)

std::string	ResolveAlias (const std::string &col, const std::map< std::string, std::string > &aliasMap)

template<typename T >
bool	ResultsSizeEq (const RVec< RVec< T > > &results, std::size_t expected, std::size_t nColumns)

template<typename T >
bool	ResultsSizeEq (const RVec< T > &results, std::size_t expected, std::size_t nColumns)

const ColumnNames_t	SelectColumns (unsigned int nRequiredNames, const ColumnNames_t &names, const ColumnNames_t &defaultNames)
	Choose between local column names or default column names, throw in case of errors.

void	TriggerRun (ROOT::RDF::RNode &node)
	Trigger the execution of an RDataFrame computation graph.

template<typename BufType , typename... ColTypes, std::size_t... Idx>
void	TTreeAsFlatMatrix (std::index_sequence< Idx... >, TTree &tree, std::vector< BufType > &matrix, std::vector< std::string > &columns)

template<typename BufType , typename... ColTypes>
void	TTreeAsFlatMatrixHelper (TTree &tree, std::vector< BufType > &matrix, std::vector< std::string > &columns)

std::string	TypeID2TypeName (const std::type_info &id)
	Returns the name of a type starting from its type_info An empty string is returned in case of failure References and pointers are not supported since those cannot be stored in columns.

char	TypeName2ROOTTypeName (const std::string &b)
	Convert type name (e.g.

const std::type_info &	TypeName2TypeID (const std::string &name)
	Return the type_info associated to a name.

template<typename T >
std::vector< T >	Union (const std::vector< T > &v1, const std::vector< T > &v2)
	Return a vector with all elements of v1 and v2 and duplicates removed.

std::shared_ptr< RNodeBase >	UpcastNode (std::shared_ptr< RNodeBase > ptr)

void	ValidateSnapshotOutput (const RSnapshotOptions &opts, const std::string &treeName, const std::string &fileName)

template<typename DS >
void	WarnOnLazySnapshotNotTriggered (const ROOT::RDF::RResultPtr< ROOT::RDF::RInterface< ROOT::Detail::RDF::RLoopManager, DS > > &r)

template<typename T >
void	WarnOnLazySnapshotNotTriggered (const ROOT::RDF::RResultPtr< T > &)

Variables
static constexpr std::size_t	kCacheLineSize = 64

Typedef Documentation

◆ Callback_t

using ROOT::Internal::RDF::Callback_t = typedef std::function<void(unsigned int)>

Definition at line 50 of file RLoopManager.hxx.

◆ RemoveFirstParameterIf_t

template<bool MustRemove, typename TypeList >

using ROOT::Internal::RDF::RemoveFirstParameterIf_t = typedef typename RemoveFirstParameterIf<MustRemove, TypeList>::type

Definition at line 149 of file Utils.hxx.

◆ RemoveFirstTwoParametersIf_t

template<bool MustRemove, typename TypeList >

using ROOT::Internal::RDF::RemoveFirstTwoParametersIf_t = typedef typename RemoveFirstTwoParametersIf<MustRemove, TypeList>::type

Definition at line 163 of file Utils.hxx.

Function Documentation

◆ AddSizeBranches()

std::pair< std::vector< std::string >, std::vector< std::string > > ROOT::Internal::RDF::AddSizeBranches	(	const std::vector< std::string > &	branches,
		TTree *	tree,
		std::vector< std::string > &&	colsWithoutAliases,
		std::vector< std::string > &&	colsWithAliases
	)

Return copies of colsWithoutAliases and colsWithAliases with size branches for variable-sized array branches added in the right positions (i.e.

before the array branches that need them).

Definition at line 994 of file RDFInterfaceUtils.cxx.

◆ AssignResults() [1/2]

template<typename T >

std::enable_if_t< IsRVec< T >::value, void > ROOT::Internal::RDF::AssignResults	(	ROOT::RVec< T > &	resStorage,
		ROOT::RVec< T > &&	tmpResults,
		std::size_t	nCols
	)

Definition at line 130 of file RVariation.hxx.

◆ AssignResults() [2/2]

template<typename T >

std::enable_if_t<!IsRVec< T >::value, void > ROOT::Internal::RDF::AssignResults	(	ROOT::RVec< T > &	resStorage,
		ROOT::RVec< T > &&	tmpResults,
		std::size_t
	)

Definition at line 119 of file RVariation.hxx.

◆ AtLeastOneEmptyString()

bool ROOT::Internal::RDF::AtLeastOneEmptyString ( const std::vector< std::string_view > strings )

Definition at line 889 of file RDFInterfaceUtils.cxx.

◆ BookDefineJit()

std::shared_ptr< RJittedDefine > ROOT::Internal::RDF::BookDefineJit	(	std::string_view	name,
		std::string_view	expression,
		RLoopManager &	lm,
		RDataSource *	ds,
		const RColumnRegister &	customCols,
		const ColumnNames_t &	branches,
		std::shared_ptr< RNodeBase > *	upcastNodeOnHeap
	)

Book the jitting of a Define call.

Definition at line 701 of file RDFInterfaceUtils.cxx.

◆ BookDefinePerSampleJit()

std::shared_ptr< RJittedDefine > ROOT::Internal::RDF::BookDefinePerSampleJit	(	std::string_view	name,
		std::string_view	expression,
		RLoopManager &	lm,
		const RColumnRegister &	customCols,
		std::shared_ptr< RNodeBase > *	upcastNodeOnHeap
	)

Book the jitting of a DefinePerSample call.

Definition at line 744 of file RDFInterfaceUtils.cxx.

◆ BookFilterJit()

std::shared_ptr< RDFDetail::RJittedFilter > ROOT::Internal::RDF::BookFilterJit	(	std::shared_ptr< RDFDetail::RNodeBase > *	prevNodeOnHeap,
		std::string_view	name,
		std::string_view	expression,
		const ColumnNames_t &	branches,
		const RColumnRegister &	customCols,
		TTree *	tree,
		RDataSource *	ds
	)

Book the jitting of a Filter call.

Definition at line 652 of file RDFInterfaceUtils.cxx.

◆ BookVariationJit()

std::shared_ptr< RJittedVariation > ROOT::Internal::RDF::BookVariationJit	(	const std::vector< std::string > &	colNames,
		std::string_view	variationName,
		const std::vector< std::string > &	variationTags,
		std::string_view	expression,
		RLoopManager &	lm,
		RDataSource *	ds,
		const RColumnRegister &	colRegister,
		const ColumnNames_t &	branches,
		std::shared_ptr< RNodeBase > *	upcastNodeOnHeap
	)

Book the jitting of a Vary call.

Definition at line 776 of file RDFInterfaceUtils.cxx.

◆ CacheLineStep()

template<typename T >

constexpr std::size_t ROOT::Internal::RDF::CacheLineStep ( )

constexpr

Stepping through CacheLineStep<T> values in a vector<T> brings you to a new cache line.

Useful to avoid false sharing.

Definition at line 220 of file Utils.hxx.

◆ CheckForDefinition()

void ROOT::Internal::RDF::CheckForDefinition	(	const std::string &	where,
		std::string_view	definedColView,
		const RColumnRegister &	customCols,
		const ColumnNames_t &	treeColumns,
		const ColumnNames_t &	dataSourceColumns
	)

Throw if column definedColView is not already there.

Definition at line 523 of file RDFInterfaceUtils.cxx.

◆ CheckForDuplicateSnapshotColumns()

void ROOT::Internal::RDF::CheckForDuplicateSnapshotColumns ( const ColumnNames_t & cols )

Definition at line 968 of file RDFInterfaceUtils.cxx.

◆ CheckForNoVariations()

void ROOT::Internal::RDF::CheckForNoVariations	(	const std::string &	where,
		std::string_view	definedColView,
		const RColumnRegister &	customCols
	)

Throw if the column has systematic variations attached.

Definition at line 554 of file RDFInterfaceUtils.cxx.

◆ CheckForRedefinition()

void ROOT::Internal::RDF::CheckForRedefinition	(	const std::string &	where,
		std::string_view	definedColView,
		const RColumnRegister &	customCols,
		const ColumnNames_t &	treeColumns,
		const ColumnNames_t &	dataSourceColumns
	)

Throw if column definedColView is already there.

Definition at line 495 of file RDFInterfaceUtils.cxx.

◆ CheckReaderTypeMatches()

void ROOT::Internal::RDF::CheckReaderTypeMatches	(	const std::type_info &	colType,
		const std::type_info &	requestedType,
		const std::string &	colName,
		const std::string &	where
	)

Definition at line 386 of file RDFUtils.cxx.

◆ CheckTypesAndPars()

void ROOT::Internal::RDF::CheckTypesAndPars	(	unsigned int	nTemplateParams,
		unsigned int	nColumnNames
	)

Definition at line 566 of file RDFInterfaceUtils.cxx.

◆ CheckValidCppVarName()

void ROOT::Internal::RDF::CheckValidCppVarName	(	std::string_view	var,
		const std::string &	where
	)

Definition at line 410 of file RDFInterfaceUtils.cxx.

◆ ColumnName2ColumnTypeName()

std::string ROOT::Internal::RDF::ColumnName2ColumnTypeName	(	const std::string &	colName,
		TTree *	tree,
		RDataSource *	ds,
		RDefineBase *	define,
		bool	vector2rvec
	)

Return a string containing the type of the given branch.

Works both with real TTree branches and with temporary column created by Define. Throws if type name deduction fails. Note that for fixed- or variable-sized c-style arrays the returned type name will be RVec<T>. vector2rvec specifies whether typename 'std::vector<T>' should be converted to 'RVec<T>' or returned as is customColID is only used if isDefine is true, and must correspond to the custom column's unique identifier returned by its GetID() method.

Definition at line 224 of file RDFUtils.cxx.

◆ ComposeRVecTypeName()

std::string ROOT::Internal::RDF::ComposeRVecTypeName ( const std::string & valueType )

Definition at line 133 of file RDFUtils.cxx.

◆ ConvertRegexToColumns()

ColumnNames_t ROOT::Internal::RDF::ConvertRegexToColumns	(	const ColumnNames_t &	colNames,
		std::string_view	columnNameRegexp,
		std::string_view	callerName
	)

Definition at line 459 of file RDFInterfaceUtils.cxx.

◆ DemangleTypeIdName()

std::string ROOT::Internal::RDF::DemangleTypeIdName ( const std::type_info & typeInfo )

Definition at line 449 of file RDFInterfaceUtils.cxx.

◆ Erase()

template<typename T >

void ROOT::Internal::RDF::Erase	(	const T &	that,
		std::vector< T > &	v
	)

Erase that element from vector v

Definition at line 187 of file Utils.hxx.

◆ FilterArraySizeColNames()

ColumnNames_t ROOT::Internal::RDF::FilterArraySizeColNames	(	const ColumnNames_t &	columnNames,
		const std::string &	action
	)

Take a list of column names, return that list with entries starting by '#' filtered out.

The function throws when filtering out a column this way.

Definition at line 371 of file RDFInterfaceUtils.cxx.

◆ FindIdxTrue()

template<typename T >

constexpr std::size_t ROOT::Internal::RDF::FindIdxTrue ( const T & arr )

constexpr

Definition at line 229 of file Utils.hxx.

◆ FindUndefinedDSColumns()

std::vector< bool > ROOT::Internal::RDF::FindUndefinedDSColumns	(	const ColumnNames_t &	requestedCols,
		const ColumnNames_t &	definedCols
	)

Return a bitset each element of which indicates whether the corresponding element in selectedColumns is the name of a column that must be defined via datasource.

All elements of the returned vector are false if no data-source is present.

Definition at line 959 of file RDFInterfaceUtils.cxx.

◆ FindUnknownColumns()

ColumnNames_t ROOT::Internal::RDF::FindUnknownColumns	(	const ColumnNames_t &	requiredCols,
		const ColumnNames_t &	datasetColumns,
		const RColumnRegister &	definedCols,
		const ColumnNames_t &	dataSourceColumns
	)

Definition at line 605 of file RDFInterfaceUtils.cxx.

◆ GetAddress() [1/2]

ULong64_t ROOT::Internal::RDF::GetAddress ( std::vector< std::string > & p )

inline

Definition at line 30 of file PyROOTHelpers.hxx.

◆ GetAddress() [2/2]

ULong64_t ROOT::Internal::RDF::GetAddress ( TTree & p )

inline

Definition at line 34 of file PyROOTHelpers.hxx.

◆ GetBranchNames()

ColumnNames_t ROOT::Internal::RDF::GetBranchNames	(	TTree &	t,
		bool	allowDuplicates = `true`
	)

Get all the branches names, including the ones of the friend trees.

Definition at line 329 of file RLoopManager.cxx.

◆ GetBranchOrLeafTypeName()

std::string ROOT::Internal::RDF::GetBranchOrLeafTypeName	(	TTree &	t,
		const std::string &	colName
	)

Return the typename of object colName stored in t, if any.

Return an empty string if colName is not in t. Supported cases:

leaves corresponding to single values, variable- and fixed-length arrays, with following syntax:
- "leafname", as long as TTree::GetLeaf resolves it
- "b1.b2...leafname", as long as TTree::GetLeaf("b1.b2....", "leafname") resolves it
TBranchElements, as long as TTree::GetBranch resolves their names

Definition at line 165 of file RDFUtils.cxx.

◆ GetColumnWidth()

unsigned int ROOT::Internal::RDF::GetColumnWidth	(	const std::vector< std::string > &	names,
		const unsigned int	minColumnSpace = `8u`
	)

Get optimal column width for printing a table given the names and the desired minimal space between columns.

Definition at line 374 of file RDFUtils.cxx.

◆ GetFilterNames()

std::vector< std::string > ROOT::Internal::RDF::GetFilterNames ( const std::shared_ptr< RLoopManager > & loopManager )

Definition at line 624 of file RDFInterfaceUtils.cxx.

◆ GetInnerValueType() [1/2]

template<typename RVec_t , typename Value_t = typename RVec_t::value_type>

std::enable_if_t< IsRVec< Value_t >::value, const std::type_info & > ROOT::Internal::RDF::GetInnerValueType ( std::size_t nCols )

Definition at line 83 of file RVariation.hxx.

◆ GetInnerValueType() [2/2]

template<typename RVec_t , typename Value_t = typename RVec_t::value_type>

std::enable_if_t<!IsRVec< Value_t >::value, const std::type_info & > ROOT::Internal::RDF::GetInnerValueType ( std::size_t )

Definition at line 77 of file RVariation.hxx.

◆ GetLeafTypeName()

std::string ROOT::Internal::RDF::GetLeafTypeName	(	TLeaf *	leaf,
		const std::string &	colName
	)

Definition at line 138 of file RDFUtils.cxx.

◆ GetNSlots()

unsigned int ROOT::Internal::RDF::GetNSlots ( )

Definition at line 285 of file RDFUtils.cxx.

◆ GetNthElement()

template<std::size_t N, typename... Ts>

decltype(auto) ROOT::Internal::RDF::GetNthElement ( Ts &&... args )

Definition at line 240 of file Utils.hxx.

◆ GetNVariations() [1/2]

template<typename T >

std::size_t ROOT::Internal::RDF::GetNVariations ( const RVec< RVec< T > > & results )

Definition at line 64 of file RVariation.hxx.

◆ GetNVariations() [2/2]

template<typename T >

std::size_t ROOT::Internal::RDF::GetNVariations ( const RVec< T > & results )

Definition at line 71 of file RVariation.hxx.

◆ GetTopLevelBranchNames()

ColumnNames_t ROOT::Internal::RDF::GetTopLevelBranchNames ( TTree & t )

Get all the top-level branches names, including the ones of the friend trees.

Definition at line 440 of file RDFInterfaceUtils.cxx.

◆ GetValidatedArgTypes()

std::vector< std::string > ROOT::Internal::RDF::GetValidatedArgTypes	(	const ColumnNames_t &	colNames,
		const RColumnRegister &	colRegister,
		TTree *	tree,
		RDataSource *	ds,
		const std::string &	context,
		bool	vector2rvec
	)

Definition at line 934 of file RDFInterfaceUtils.cxx.

◆ GetValidatedColumnNames()

ColumnNames_t ROOT::Internal::RDF::GetValidatedColumnNames	(	RLoopManager &	lm,
		const unsigned int	nColumns,
		const ColumnNames_t &	columns,
		const RColumnRegister &	customColumns,
		RDataSource *	ds
	)

Given the desired number of columns and the user-provided list of columns:

fallback to using the first nColumns default columns if needed (or throw if nColumns > nDefaultColumns)
check that selected column names refer to valid branches, custom columns or datasource columns (throw if not)
replace column names from aliases by the actual column name Return the list of selected column names.

Definition at line 908 of file RDFInterfaceUtils.cxx.

◆ GetVectorAddress()

template<typename dtype >

ULong64_t ROOT::Internal::RDF::GetVectorAddress ( std::vector< dtype > & p )

Definition at line 25 of file PyROOTHelpers.hxx.

◆ InterpreterCalc()

Long64_t ROOT::Internal::RDF::InterpreterCalc	(	const std::string &	code,
		const std::string &	context = `""`
	)

Jit code in the interpreter with TInterpreter::Calc, throw in case of errors.

The optional context parameter, if present, is mentioned in the error message. The pointer returned by the call to TInterpreter::Calc is returned in case of success.

Definition at line 329 of file RDFUtils.cxx.

◆ InterpreterDeclare()

void ROOT::Internal::RDF::InterpreterDeclare ( const std::string & code )

Declare code in the interpreter via the TInterpreter::Declare method, throw in case of errors.

Definition at line 317 of file RDFUtils.cxx.

◆ IsInternalColumn()

bool ROOT::Internal::RDF::IsInternalColumn ( std::string_view colName )

Whether custom column with name colName is an "internal" column such as rdfentry_ or rdfslot_.

Definition at line 365 of file RDFUtils.cxx.

◆ IsStrInVec()

bool ROOT::Internal::RDF::IsStrInVec	(	const std::string &	str,
		const std::vector< std::string > &	vec
	)

Definition at line 419 of file RDFUtils.cxx.

◆ JitBuildAction()

std::string ROOT::Internal::RDF::JitBuildAction	(	const ColumnNames_t &	cols,
		std::shared_ptr< RDFDetail::RNodeBase > *	prevNode,
		const std::type_info &	helperArgType,
		const std::type_info &	at,
		void *	helperArgOnHeap,
		TTree *	tree,
		const unsigned int	nSlots,
		const RColumnRegister &	customCols,
		RDataSource *	ds,
		std::weak_ptr< RJittedAction > *	jittedActionOnHeap
	)

Definition at line 839 of file RDFInterfaceUtils.cxx.

◆ MakeColumnReader()

template<typename T >

std::unique_ptr< RDFDetail::RColumnReaderBase > ROOT::Internal::RDF::MakeColumnReader	(	unsigned int	slot,
		RDefineBase *	define,
		const std::map< std::string, std::vector< void * > > &	DSValuePtrsMap,
		TTreeReader *	r,
		ROOT::RDF::RDataSource *	ds,
		const std::string &	colName,
		RVariationBase *	variation,
		const std::string &	variationName
	)

Definition at line 44 of file ColumnReaderUtils.hxx.

◆ MakeColumnReaders() [1/2]

template<typename... ColTypes>

std::array< std::unique_ptr< RDFDetail::RColumnReaderBase >, sizeof...(ColTypes)> ROOT::Internal::RDF::MakeColumnReaders	(	unsigned int	slot,
		TTreeReader *	r,
		TypeList< ColTypes... >	,
		const RColumnReadersInfo &	colInfo,
		const std::string &	variationName = `"nominal"`
	)

Create a group of column readers, one per type in the parameter pack.

colInfo.fColNames and colInfo.fIsDefine are expected to have size equal to the parameter pack, and elements ordered accordingly, i.e. fIsDefine[0] refers to fColNames[0] which is of type "ColTypes[0]".

Pre-condition: colInfo.isDefine must not be null.

Definition at line 100 of file ColumnReaderUtils.hxx.

◆ MakeColumnReaders() [2/2]

std::array< std::unique_ptr< RDFDetail::RColumnReaderBase >, 0 > ROOT::Internal::RDF::MakeColumnReaders	(	unsigned int	,
		TTreeReader *	,
		TypeList<>	,
		const RColumnReadersInfo &	,
		const std::string &	= `"nominal"`
	)

inline

Definition at line 136 of file ColumnReaderUtils.hxx.

◆ MakeDataFrameFromSpec()

ROOT::RDataFrame ROOT::Internal::RDF::MakeDataFrameFromSpec ( const RDatasetSpec & spec )

Definition at line 17 of file RDFInternalUtils.cxx.

◆ MakeNumpyDataFrame()

template<typename... ColumnTypes>

RDataFrame * ROOT::Internal::RDF::MakeNumpyDataFrame	(	PyObject *	pyRVecs,
		std::pair< std::string, ROOT::RVec< ColumnTypes > * > &&...	colNameProxyPairs
	)

Definition at line 225 of file RNumpyDS.hxx.

◆ MakeResultMap()

template<typename T >

ROOT::RDF::Experimental::RResultMap< T > ROOT::Internal::RDF::MakeResultMap	(	std::shared_ptr< T >	nominalResult,
		std::vector< std::shared_ptr< T > > &&	variedResults,
		std::vector< std::string > &&	keys,
		RLoopManager &	lm,
		std::shared_ptr< ROOT::Internal::RDF::RActionBase >	nominalAction,
		std::shared_ptr< ROOT::Internal::RDF::RActionBase >	variedAction
	)

Definition at line 38 of file RResultMap.hxx.

◆ MakeRootDataFrame()

RDataFrame ROOT::Internal::RDF::MakeRootDataFrame	(	std::string_view	treeName,
		std::string_view	fileNameGlob
	)

Definition at line 171 of file RRootDS.cxx.

◆ NotHelper() [1/2]

template<typename... ArgTypes, typename F >

std::function< bool(ArgTypes...)> ROOT::Internal::RDF::NotHelper	(	ROOT::TypeTraits::TypeList< ArgTypes... >	,
		F &&	f
	)

Definition at line 36 of file RDFHelpers.hxx.

◆ NotHelper() [2/2]

template<typename... ArgTypes, typename Ret , typename... Args>

std::function< bool(ArgTypes...)> ROOT::Internal::RDF::NotHelper	(	ROOT::TypeTraits::TypeList< ArgTypes... >	,
		Ret(*)(Args...)	f
	)

Definition at line 42 of file RDFHelpers.hxx.

◆ ParseTreePath()

ParsedTreePath ROOT::Internal::RDF::ParseTreePath ( std::string_view fullTreeName )

Definition at line 629 of file RDFInterfaceUtils.cxx.

◆ PassAsVec()

template<std::size_t N, typename T , typename F >

auto ROOT::Internal::RDF::PassAsVec ( F && f ) -> PassAsVecHelper<std::make_index_sequence<N>, T, F>

Definition at line 62 of file RDFHelpers.hxx.

◆ PrettyPrintAddr()

std::string ROOT::Internal::RDF::PrettyPrintAddr ( const void *const addr )

Definition at line 642 of file RDFInterfaceUtils.cxx.

◆ RDataFrameTake()

template<typename T >

ROOT::RDF::RResultPtr< std::vector< T > > ROOT::Internal::RDF::RDataFrameTake	(	ROOT::RDF::RNode	df,
		std::string_view	column
	)

Definition at line 67 of file PyROOTHelpers.hxx.

◆ RemoveDuplicates()

void ROOT::Internal::RDF::RemoveDuplicates ( ColumnNames_t & columnNames )

Definition at line 1031 of file RDFInterfaceUtils.cxx.

◆ ReplaceDotWithUnderscore()

std::vector< std::string > ROOT::Internal::RDF::ReplaceDotWithUnderscore ( const std::vector< std::string > & columnNames )

Replace occurrences of '.

' with '_' in each string passed as argument. An Info message is printed when this happens. Dots at the end of the string are not replaced. An exception is thrown in case the resulting set of strings would contain duplicates.

Definition at line 298 of file RDFUtils.cxx.

◆ ResizeResults() [1/2]

template<typename T >

std::enable_if_t< IsRVec< T >::value, void > ROOT::Internal::RDF::ResizeResults	(	ROOT::RVec< T > &	results,
		std::size_t	nCols,
		std::size_t	nVariations
	)

Definition at line 102 of file RVariation.hxx.

◆ ResizeResults() [2/2]

template<typename T >

std::enable_if_t<!IsRVec< T >::value, void > ROOT::Internal::RDF::ResizeResults	(	ROOT::RVec< T > &	results,
		std::size_t	,
		std::size_t	nVariations
	)

Definition at line 94 of file RVariation.hxx.

◆ ResolveAlias()

std::string ROOT::Internal::RDF::ResolveAlias	(	const std::string &	col,
		const std::map< std::string, std::string > &	aliasMap
	)

Definition at line 397 of file RDFInterfaceUtils.cxx.

◆ ResultsSizeEq() [1/2]

template<typename T >

bool ROOT::Internal::RDF::ResultsSizeEq	(	const RVec< RVec< T > > &	results,
		std::size_t	expected,
		std::size_t	nColumns
	)

Definition at line 46 of file RVariation.hxx.

◆ ResultsSizeEq() [2/2]

template<typename T >

bool ROOT::Internal::RDF::ResultsSizeEq	(	const RVec< T > &	results,
		std::size_t	expected,
		std::size_t	nColumns
	)

Definition at line 55 of file RVariation.hxx.

◆ SelectColumns()

const ColumnNames_t ROOT::Internal::RDF::SelectColumns	(	unsigned int	nRequiredNames,
		const ColumnNames_t &	names,
		const ColumnNames_t &	defaultNames
	)

Choose between local column names or default column names, throw in case of errors.

Definition at line 580 of file RDFInterfaceUtils.cxx.

◆ TriggerRun()

void ROOT::Internal::RDF::TriggerRun ( ROOT::RDF::RNode & node )

Trigger the execution of an RDataFrame computation graph.

Parameters

[in] node A node of the computation graph (not a result).

This function calls the RLoopManager::Run method on the fLoopManager data member of the input argument. It is intended for internal use only.

Definition at line 987 of file RDFInterfaceUtils.cxx.

◆ TTreeAsFlatMatrix()

template<typename BufType , typename... ColTypes, std::size_t... Idx>

void ROOT::Internal::RDF::TTreeAsFlatMatrix	(	std::index_sequence< Idx... >	,
		TTree &	tree,
		std::vector< BufType > &	matrix,
		std::vector< std::string > &	columns
	)

Definition at line 40 of file PyROOTHelpers.hxx.

◆ TTreeAsFlatMatrixHelper()

template<typename BufType , typename... ColTypes>

void ROOT::Internal::RDF::TTreeAsFlatMatrixHelper	(	TTree &	tree,
		std::vector< BufType > &	matrix,
		std::vector< std::string > &	columns
	)

Definition at line 58 of file PyROOTHelpers.hxx.

◆ TypeID2TypeName()

std::string ROOT::Internal::RDF::TypeID2TypeName ( const std::type_info & id )

Returns the name of a type starting from its type_info An empty string is returned in case of failure References and pointers are not supported since those cannot be stored in columns.

Definition at line 99 of file RDFUtils.cxx.

◆ TypeName2ROOTTypeName()

char ROOT::Internal::RDF::TypeName2ROOTTypeName ( const std::string & b )

Convert type name (e.g.

"Float_t") to ROOT type code (e.g. 'F') – see TBranch documentation. Return a space ' ' in case no match was found.

Definition at line 254 of file RDFUtils.cxx.

◆ TypeName2TypeID()

const std::type_info & ROOT::Internal::RDF::TypeName2TypeID ( const std::string & name )

Return the type_info associated to a name.

If the association fails, an exception is thrown. References and pointers are not supported since those cannot be stored in columns.

Definition at line 51 of file RDFUtils.cxx.

◆ Union()

template<typename T >

std::vector< T > ROOT::Internal::RDF::Union	(	const std::vector< T > &	v1,
		const std::vector< T > &	v2
	)

Return a vector with all elements of v1 and v2 and duplicates removed.

Precondition: each of v1 and v2 must not have duplicate elements.

Definition at line 274 of file Utils.hxx.

◆ UpcastNode()

std::shared_ptr< RNodeBase > ROOT::Internal::RDF::UpcastNode ( std::shared_ptr< RNodeBase > ptr )

Definition at line 898 of file RDFInterfaceUtils.cxx.

◆ ValidateSnapshotOutput()

void ROOT::Internal::RDF::ValidateSnapshotOutput	(	const RSnapshotOptions &	opts,
		const std::string &	treeName,
		const std::string &	fileName
	)

Definition at line 238 of file RDFActionHelpers.cxx.

◆ WarnOnLazySnapshotNotTriggered() [1/2]

template<typename DS >

void ROOT::Internal::RDF::WarnOnLazySnapshotNotTriggered ( const ROOT::RDF::RResultPtr< ROOT::RDF::RInterface< ROOT::Detail::RDF::RLoopManager, DS > > & r )

Definition at line 52 of file RResultPtr.hxx.

◆ WarnOnLazySnapshotNotTriggered() [2/2]

template<typename T >

void ROOT::Internal::RDF::WarnOnLazySnapshotNotTriggered ( const ROOT::RDF::RResultPtr< T > & )

inline

Definition at line 47 of file RResultPtr.hxx.

Variable Documentation

◆ kCacheLineSize

constexpr std::size_t ROOT::Internal::RDF::kCacheLineSize = 64

staticconstexpr

Definition at line 214 of file Utils.hxx.

Namespaces

Classes

Typedefs

Functions

Variables

Typedef Documentation

◆ Callback_t

◆ RemoveFirstParameterIf_t

◆ RemoveFirstTwoParametersIf_t

Function Documentation

◆ AddSizeBranches()

◆ AssignResults() [1/2]

◆ AssignResults() [2/2]

◆ AtLeastOneEmptyString()

◆ BookDefineJit()

◆ BookDefinePerSampleJit()

◆ BookFilterJit()

◆ BookVariationJit()

◆ CacheLineStep()

◆ CheckForDefinition()

◆ CheckForDuplicateSnapshotColumns()

◆ CheckForNoVariations()

◆ CheckForRedefinition()

◆ CheckReaderTypeMatches()

◆ CheckTypesAndPars()

◆ CheckValidCppVarName()

◆ ColumnName2ColumnTypeName()

◆ ComposeRVecTypeName()

◆ ConvertRegexToColumns()

◆ DemangleTypeIdName()

◆ Erase()

◆ FilterArraySizeColNames()

◆ FindIdxTrue()

◆ FindUndefinedDSColumns()

◆ FindUnknownColumns()

◆ GetAddress() [1/2]

◆ GetAddress() [2/2]

◆ GetBranchNames()

◆ GetBranchOrLeafTypeName()

◆ GetColumnWidth()

◆ GetFilterNames()

◆ GetInnerValueType() [1/2]

◆ GetInnerValueType() [2/2]

◆ GetLeafTypeName()

◆ GetNSlots()

◆ GetNthElement()

◆ GetNVariations() [1/2]

◆ GetNVariations() [2/2]

◆ GetTopLevelBranchNames()

◆ GetValidatedArgTypes()

◆ GetValidatedColumnNames()

◆ GetVectorAddress()

◆ InterpreterCalc()

◆ InterpreterDeclare()

◆ IsInternalColumn()

◆ IsStrInVec()

◆ JitBuildAction()

◆ MakeColumnReader()

◆ MakeColumnReaders() [1/2]

◆ MakeColumnReaders() [2/2]

◆ MakeDataFrameFromSpec()

◆ MakeNumpyDataFrame()

◆ MakeResultMap()

◆ MakeRootDataFrame()

◆ NotHelper() [1/2]

◆ NotHelper() [2/2]

◆ ParseTreePath()

◆ PassAsVec()

◆ PrettyPrintAddr()

◆ RDataFrameTake()

◆ RemoveDuplicates()

◆ ReplaceDotWithUnderscore()

◆ ResizeResults() [1/2]

◆ ResizeResults() [2/2]

◆ ResolveAlias()

◆ ResultsSizeEq() [1/2]

◆ ResultsSizeEq() [2/2]

◆ SelectColumns()

◆ TriggerRun()

◆ TTreeAsFlatMatrix()