RNTuple is the modern way of storing columnar datasets: please consider to use it before starting new projects based on TTree and related classes.

In order to store columnar datasets, ROOT historically provides the TTree, TChain, TNtuple and TNtupleD classes. The TTree class represents a columnar dataset. Any C++ type can be stored in the columns. The TTree has allowed to store about 1 EB of data coming from the LHC alone: it is demonstrated to scale and it's battle tested. It has been optimized during the years to reduce dataset sizes on disk and to deliver excellent runtime performance. It allows to access only part of the columns of the datasets, too. The TNtuple and TNtupleD classes are specialisations of the TTree class which can only hold single precision and double precision floating-point numbers respectively; The TChain is a collection of TTrees, which can be located also in different files.

Topics
	TreePlayer
	It contains utilities to plot data stored in a TTree.

Namespaces
namespace	ROOT::Internal::TreeUtils
	Namespace hosting functions and classes to retrieve tree information for internal use.

Classes
struct	ROOT::TreeUtils::RFriendInfo
	Information about friend trees of a certain TTree or TChain object. More...
class	TBasket
	Manages buffers for branches of a Tree. More...
class	TBasketSQL
	Implement TBasket for a SQL backend. More...
class	TBranch
	A TTree is a list of TBranches. More...
class	TBranchClones
	A Branch for the case of an array of clone objects. More...
class	TBranchElement
	A Branch for the case of an object. More...
class	TBranchObject
	A Branch for the case of an object. More...
class	TBranchRef
	A branch containing and managing a TRefTable for TRef autoloading. More...
class	TBranchSTL
	A Branch handling STL collection of pointers (vectors, lists, queues, sets and multisets) while storing them in split mode. More...
class	TBufferSQL
	Implement TBuffer for a SQL backend. More...
class	TChain
	A chain is a collection of files containing TTree objects. More...
class	TChainElement
	A TChainElement describes a component of a TChain. More...
class	TCollectionMethodBrowsable
	TCollectionMethodBrowsable extends TCollectionPropertyBrowsable by showing all methods of the collection itself. More...
class	TCollectionPropertyBrowsable
	A tiny browser helper object (and its generator) for adding a virtual (as in "not actually part of the class", not in C++ virtual) "@size()" method to a collection. More...
class	TCut
	A specialized string object used for TTree selections. More...
class	TEntryListArray
	A list of entries and subentries in a TTree or TChain. More...
class	TEntryListFromFile
	Manages entry lists from different files, when they are not loaded in memory at the same time. More...
class	TEventList
	Legacy Code TEventList is a legacy interface: there will be no bug fixes nor new developments. Therefore it is not recommended to use it in new long-term production code. But, depending on the context, using TEventList might still be a valid solution. More...
class	TFriendElement
	A TFriendElement TF describes a TTree object TF in a file. More...
class	ROOT::TIOFeatures
	TIOFeatures provides the end-user with the ability to change the IO behavior of data written via a TTree. More...
class	TLeaf
	A TLeaf describes individual elements of a TBranch See TBranch structure in TTree. More...
class	TLeafB
	A TLeaf for an 8 bit Integer data type. More...
class	TLeafC
	A TLeaf for a variable length string. More...
class	TLeafD
	A TLeaf for a 64 bit floating point data type. More...
class	TLeafD32
	A TLeaf for a 24 bit truncated floating point data type. More...
class	TLeafElement
	A TLeaf for the general case when using the branches created via a TStreamerInfo (i.e. More...
class	TLeafF
	A TLeaf for a 32 bit floating point data type. More...
class	TLeafF16
	A TLeaf for a 24 bit truncated floating point data type. More...
class	TLeafG
	A TLeaf for a long integer data type (Long_t, non-portable size). More...
class	TLeafI
	A TLeaf for an Integer data type. More...
class	TLeafL
	A TLeaf for a 64 bit Integer data type. More...
class	TLeafO
	A TLeaf for a bool data type. More...
class	TLeafObject
	A TLeaf for a general object derived from TObject. More...
class	TLeafS
	A TLeaf for a 16 bit Integer data type. More...
class	TMethodBrowsable
	This helper object allows the browsing of methods of objects stored in branches. More...
class	TNonSplitBrowsable
	Allows a TBrowser to browse non-split branches as if they were split. More...
class	TNtuple
	A simple TTree restricted to a list of float variables only. More...
class	TNtupleD
	A simple TTree restricted to a list of double variables only. More...
class	TreeUtils
	Different standalone functions to work with trees and tuples, not reqiuired to be a member of any class. More...
class	TSelector
	A TSelector object is used by the TTree::Draw, TTree::Scan, TTree::Process to navigate in a TTree and make selections. More...
class	TSelectorList
	A TList derived class that makes sure that objects added to it are not linked to the currently open file (like histograms, eventlists and trees). More...
class	TSelectorScalar
	Named scalar type, based on Long64_t, streamable, storable and mergeable. More...
class	TTree
	A TTree represents a columnar dataset. More...
class	TTreeCache
	A cache to speed-up the reading of ROOT datasets. More...
class	TTreeCacheUnzip
	A TTreeCache which exploits parallelized decompression of its own content. More...
class	TTreeCloner
	Class implementing or helping the various TTree cloning method. More...
class	TTreeResult
	Class defining interface to a TTree query result with the same interface as for SQL databases. More...
class	TTreeRow
	Class defining interface to a row of a TTree query result. More...
class	TTreeSQL
	A TTree object is a list of TBranch. More...
class	TVirtualBranchBrowsable
	TVirtualBranchBrowsable is a base class (not really abstract, but useless by itself) for helper objects that extend TBranch's browsing support. More...
class	TVirtualIndex
	Abstract interface for Tree Index. More...
class	TVirtualTreePlayer
	Abstract base class defining the interface for the plugins that implement Draw, Scan, Process, MakeProxy, etc. More...

Functions
std::vector< std::string >	ROOT::Internal::TreeUtils::GetFileNamesFromTree (const TTree &tree)
	Get and store the file names associated with the input tree.
std::vector< std::string >	ROOT::Internal::TreeUtils::GetTreeFullPaths (const TTree &tree)
	Retrieve the full path(s) to a TTree or the trees in a TChain.

Function Documentation

◆ GetFileNamesFromTree()

std::vector< std::string > ROOT::Internal::TreeUtils::GetFileNamesFromTree ( const TTree & tree )

Get and store the file names associated with the input tree.

Parameters

[in] tree The tree from which friends information will be gathered.

Exceptions

std::runtime_error If no files could be associated with the input tree.

Definition at line 89 of file InternalTreeUtils.cxx.

◆ GetTreeFullPaths()

std::vector< std::string > ROOT::Internal::TreeUtils::GetTreeFullPaths ( const TTree & tree )

Retrieve the full path(s) to a TTree or the trees in a TChain.

Parameters

[in] tree The tree or chain from which the paths will be retrieved.

Exceptions

std::runtime_error If the input tree is a TChain but no files could be found associated with it.

Returns: If the input argument is a TChain, returns a vector of strings with the name of the tree of each file in the chain. If the input argument is a TTree, returns a vector with a single element that is the full path of the tree in the file (e.g. the name of the tree itself or the path with the directories inside the file). Finally, the function returns a vector with just the name of the tree if it couldn't do any better.

Definition at line 304 of file InternalTreeUtils.cxx.

Topics

Namespaces

Classes

Legacy Code

Functions

Function Documentation

◆ GetFileNamesFromTree()

◆ GetTreeFullPaths()