Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TTreeFormula Class Reference

Used to pass a selection expression to the Tree drawing routine.

See TTree::Draw

A TreeFormula can contain any arithmetic expression including standard operators and mathematical functions separated by operators. Examples of valid expression:

"x<y && sqrt(z)>3.2"

TTreeFormula now relies on a variety of TFormLeafInfo classes to handle the reading of the information. Here is the list of theses classes:

The following method are available from the TFormLeafInfo interface:

  • AddOffset(Int_t offset, TStreamerElement* element)
  • GetCounterValue(TLeaf* leaf) : return the size of the array pointed to.
  • GetObjectAddress(TLeafElement* leaf) : Returns the location of the object pointed to.
  • GetMultiplicity() : Returns info on the variability of the number of elements
  • GetNdata(TLeaf* leaf) : Returns the number of elements
  • GetNdata() : Used by GetNdata(TLeaf* leaf)
  • GetValue(TLeaf *leaf, Int_t instance = 0) : Return the value
  • GetValuePointer(TLeaf *leaf, Int_t instance = 0) : Returns the address of the value
  • GetLocalValuePointer(TLeaf *leaf, Int_t instance = 0) : Returns the address of the value of 'this' LeafInfo
  • IsString()
  • ReadValue(char *where, Int_t instance = 0) : Internal function to interpret the location 'where'
  • Update() : react to the possible loading of a shared library.

Definition at line 58 of file TTreeFormula.h.

Classes

struct  RealInstanceCache
 

Public Member Functions

 TTreeFormula ()
 
 TTreeFormula (const char *name, const char *formula, TTree *tree)
 Normal TTree Formula Constructor.
 
 ~TTreeFormula () override
 Tree Formula default destructor.
 
Int_t DefinedVariable (TString &variable, Int_t &action) override
 Check if name is in the list of Tree/Branch leaves.
 
virtual TClassEvalClass () const
 Evaluate the class of this treeformula.
 
template<typename T >
EvalInstance (Int_t i=0, const char *stringStack[]=nullptr)
 Evaluate this treeformula.
 
virtual Double_t EvalInstance (Int_t i=0, const char *stringStack[]=nullptr)
 Double_t template specialization of EvalInstance.
 
virtual Long64_t EvalInstance64 (Int_t i=0, const char *stringStack[]=nullptr)
 Long64_t template specialization of EvalInstance.
 
virtual LongDouble_t EvalInstanceLD (Int_t i=0, const char *stringStack[]=nullptr)
 LongDouble_t template specialization of EvalInstance.
 
virtual void * EvalObject (Int_t i=0)
 Evaluate this treeformula.
 
virtual const char * EvalStringInstance (Int_t i=0)
 Eval the instance as a string.
 
template<>
LongDouble_t GetConstant (Int_t k)
 
virtual TLeafGetLeaf (Int_t n) const
 Return leaf corresponding to serial number n.
 
TFormLeafInfoGetLeafInfo (Int_t code) const
 Return DataMember corresponding to code.
 
TTreeFormulaManagerGetManager () const
 
TMethodCallGetMethodCall (Int_t code) const
 Return methodcall corresponding to code.
 
virtual Int_t GetMultiplicity () const
 
virtual Int_t GetNcodes () const
 
virtual Int_t GetNdata ()
 Return number of available instances in the formula.
 
virtual TTreeGetTree () const
 
TClassIsA () const override
 
virtual bool IsInteger (bool fast=true) const
 Return TRUE if the formula corresponds to one single Tree leaf and this leaf is short, int or unsigned short, int When a leaf is of type integer or string, the generated histogram is forced to have an integer bin width.
 
bool IsQuickLoad () const
 
virtual bool IsString () const
 Return TRUE if the formula is a string.
 
bool Notify () override
 This method must be overridden to handle object notification (the base implementation is no-op).
 
virtual char * PrintValue (Int_t mode, Int_t instance, const char *decform="9.9") const
 Return value of variable as a string.
 
virtual char * PrintValue (Int_t mode=0) const
 Return value of variable as a string.
 
virtual void ResetLoading ()
 Tell the formula that we are going to request a new entry.
 
virtual void SetAxis (TAxis *axis=nullptr)
 Set the axis (in particular get the type).
 
void SetQuickLoad (bool quick)
 
virtual void SetTree (TTree *tree)
 
void Streamer (TBuffer &) override
 Stream an object of class TTreeFormula.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void UpdateFormulaLeaves ()
 This function is called TTreePlayer::UpdateFormulaLeaves, itself called by TChain::LoadTree when a new Tree is loaded.
 
- Public Member Functions inherited from ROOT::v5::TFormula
 TFormula ()
 Formula default constructor.
 
 TFormula (const char *name, const char *formula)
 Normal Formula constructor.
 
 TFormula (const TFormula &formula)
 Default constructor.
 
 ~TFormula () override
 Formula default destructor.
 
virtual void Analyze (const char *schain, Int_t &err, Int_t offset=0)
 Analyze a sub-expression in one formula.
 
virtual Bool_t AnalyzeFunction (TString &chaine, Int_t &err, Int_t offset=0)
 Check if the chain as function call.
 
void Clear (Option_t *option="") override
 Resets the objects.
 
virtual Int_t Compile (const char *expression="")
 Compile expression already stored in fTitle.
 
void Copy (TObject &formula) const override
 Copy this formula.
 
virtual char * DefinedString (Int_t code)
 Return address of string corresponding to special code.
 
virtual Double_t DefinedValue (Int_t code)
 Return value corresponding to special code.
 
virtual Double_t Eval (Double_t x, Double_t y=0, Double_t z=0, Double_t t=0) const
 Evaluate this formula.
 
virtual Double_t EvalPar (const Double_t *x, const Double_t *params=nullptr)
 
virtual Double_t EvalParOld (const Double_t *x, const Double_t *params=nullptr)
 Evaluate this formula.
 
virtual TString GetExpFormula (Option_t *option="") const
 Reconstruct the formula expression from the internal TFormula member variables.
 
virtual const TObjectGetLinearPart (Int_t i)
 Return linear part.
 
virtual Int_t GetNdim () const
 
virtual Int_t GetNpar () const
 
virtual Int_t GetNumber () const
 
Double_t GetParameter (const char *name) const
 Return value of parameter named parName.
 
Double_t GetParameter (Int_t ipar) const
 Return value of parameter number ipar.
 
virtual Double_tGetParameters () const
 
virtual void GetParameters (Double_t *params)
 
virtual const char * GetParName (Int_t ipar) const
 Return name of one parameter.
 
virtual Int_t GetParNumber (const char *name) const
 Return parameter number by name.
 
virtual Bool_t IsLinear () const
 
virtual Bool_t IsNormalized () const
 
TFormulaoperator= (const TFormula &rhs)
 Operator =.
 
void Optimize ()
 MI include.
 
void Print (Option_t *option="") const override
 Dump this formula with its attributes.
 
virtual void ProcessLinear (TString &replaceformula)
 If the formula is for linear fitting, change the title to normal and fill the LinearParts array.
 
virtual void SetNumber (Int_t number)
 
virtual void SetParameter (const char *name, Double_t parvalue)
 Initialize parameter number ipar.
 
virtual void SetParameter (Int_t ipar, Double_t parvalue)
 Initialize parameter number ipar.
 
virtual void SetParameters (const Double_t *params)
 Initialize array of all parameters.
 
virtual void SetParameters (Double_t p0, Double_t p1, Double_t p2=0, Double_t p3=0, Double_t p4=0, Double_t p5=0, Double_t p6=0, Double_t p7=0, Double_t p8=0, Double_t p9=0, Double_t p10=0)
 Initialize up to 11 parameters All arguments except THE FIRST TWO are optional In case of a function with only one parameter, call this function with p1=0.
 
virtual void SetParName (Int_t ipar, const char *name)
 Set name of parameter number ipar.
 
virtual void SetParNames (const char *name0="p0", const char *name1="p1", const char *name2="p2", const char *name3="p3", const char *name4="p4", const char *name5="p5", const char *name6="p6", const char *name7="p7", const char *name8="p8", const char *name9="p9", const char *name10="p10")
 Set up to 11 parameter names.
 
void Streamer (TBuffer &b, const TClass *onfile_class)
 Stream a class object.
 
void Streamer (TBuffer &b, Int_t version, UInt_t start, UInt_t count, const TClass *onfile_class=nullptr)
 specialized streamer function being able to read old TF1 versions as TF1Old in memory
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void Update ()
 
- Public Member Functions inherited from TNamed
 TNamed ()
 
 TNamed (const char *name, const char *title)
 
 TNamed (const TNamed &named)
 TNamed copy ctor.
 
 TNamed (const TString &name, const TString &title)
 
virtual ~TNamed ()
 TNamed destructor.
 
void Clear (Option_t *option="") override
 Set name and title to empty strings ("").
 
TObjectClone (const char *newname="") const override
 Make a clone of an object using the Streamer facility.
 
Int_t Compare (const TObject *obj) const override
 Compare two TNamed objects.
 
void Copy (TObject &named) const override
 Copy this to obj.
 
virtual void FillBuffer (char *&buffer)
 Encode TNamed into output buffer.
 
const char * GetName () const override
 Returns name of object.
 
const char * GetTitle () const override
 Returns title of object.
 
ULong_t Hash () const override
 Return hash value for this object.
 
Bool_t IsSortable () const override
 
void ls (Option_t *option="") const override
 List TNamed name and title.
 
TNamedoperator= (const TNamed &rhs)
 TNamed assignment operator.
 
void Print (Option_t *option="") const override
 Print TNamed name and title.
 
virtual void SetName (const char *name)
 Set the name of the TNamed.
 
virtual void SetNameTitle (const char *name, const char *title)
 Set all the TNamed parameters (name and title).
 
virtual void SetTitle (const char *title="")
 Set the title of the TNamed.
 
virtual Int_t Sizeof () const
 Return size of the TNamed part of the TObject.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor.
 
 TObject (const TObject &object)
 TObject copy ctor.
 
virtual ~TObject ()
 TObject destructor.
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract.
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad.
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action.
 
ULong_t CheckedHash ()
 Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs.
 
virtual void Delete (Option_t *option="")
 Delete this object.
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object.
 
virtual void Draw (Option_t *option="")
 Default Draw method for all objects.
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs.
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).
 
virtual void Dump () const
 Dump contents of object on stdout.
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message.
 
virtual void Execute (const char *method, const char *params, Int_t *error=nullptr)
 Execute method on this object with the given parameter string, e.g.
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=nullptr)
 Execute method on this object with parameters stored in the TObjArray.
 
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py).
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message.
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes.
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes.
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object.
 
virtual const char * GetIconName () const
 Returns mime type name of object.
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py).
 
virtual Option_tGetOption () const
 
virtual UInt_t GetUniqueID () const
 Return the unique object id.
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out.
 
Bool_t HasInconsistentHash () const
 Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message.
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname".
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl.
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas.
 
void InvertBit (UInt_t f)
 
Bool_t IsDestructed () const
 IsDestructed.
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory).
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
 
R__ALWAYS_INLINE Bool_t IsOnHeap () const
 
R__ALWAYS_INLINE Bool_t IsZombie () const
 
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary).
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete.
 
void operator delete (void *ptr)
 Operator delete.
 
void operator delete (void *ptr, void *vp)
 Only called by placement new when throwing an exception.
 
void operator delete[] (void *ptr)
 Operator delete [].
 
void operator delete[] (void *ptr, void *vp)
 Only called by placement new[] when throwing an exception.
 
void * operator new (size_t sz)
 
void * operator new (size_t sz, void *vp)
 
void * operator new[] (size_t sz)
 
void * operator new[] (size_t sz, void *vp)
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator.
 
virtual void Paint (Option_t *option="")
 This method must be overridden if a class wants to paint itself.
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list.
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory.
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list.
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename.
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out".
 
void SetBit (UInt_t f)
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f.
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object.
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message.
 
R__ALWAYS_INLINE Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory.
 

Static Public Member Functions

static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from ROOT::v5::TFormula
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static void GetMaxima (Int_t &maxop, Int_t &maxpar, Int_t &maxconst)
 static function to get the maximum value of 3 parameters -maxop : maximum number of operations -maxpar : maximum number of parameters -maxconst : maximum number of constants
 
static void SetMaxima (Int_t maxop=1000, Int_t maxpar=1000, Int_t maxconst=1000)
 static function to set the maximum value of 3 parameters
 
- Static Public Member Functions inherited from TNamed
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from TObject
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static Longptr_t GetDtorOnly ()
 Return destructor only flag.
 
static Bool_t GetObjectStat ()
 Get status of object stat flag.
 
static void SetDtorOnly (void *obj)
 Set destructor only flag.
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable.
 

Protected Types

enum  {
  kDirect , kDataMember , kMethod , kIndexOfEntry ,
  kEntries , kLength , kIteration , kLengthFunc ,
  kSum , kEntryList , kTreeMember , kIndexOfLocalEntry ,
  kMin , kMax , kLocalEntries
}
 
enum  {
  kAlias = 200 , kAliasString = 201 , kAlternate = 202 , kAlternateString = 203 ,
  kMinIf = 204 , kMaxIf = 205
}
 
enum  EStatusBits { kIsCharacter = (1ULL << ( 12 )) , kMissingLeaf = (1ULL << ( 15 )) , kIsInteger = (1ULL << ( 17 )) , kNeedEntries = (1ULL << ( 18 )) }
 
- Protected Types inherited from ROOT::v5::TFormula
enum  {
  kEnd = 0 , kAdd = 1 , kSubstract = 2 , kMultiply = 3 ,
  kDivide = 4 , kModulo = 5 , kcos = 10 , ksin = 11 ,
  ktan = 12 , kacos = 13 , kasin = 14 , katan = 15 ,
  katan2 = 16 , kfmod = 17 , kpow = 20 , ksq = 21 ,
  ksqrt = 22 , kstrstr = 23 , kmin = 24 , kmax = 25 ,
  klog = 30 , kexp = 31 , klog10 = 32 , kpi = 40 ,
  kabs = 41 , ksign = 42 , kint = 43 , kSignInv = 44 ,
  krndm = 50 , kAnd = 60 , kOr = 61 , kEqual = 62 ,
  kNotEqual = 63 , kLess = 64 , kGreater = 65 , kLessThan = 66 ,
  kGreaterThan = 67 , kNot = 68 , kcosh = 70 , ksinh = 71 ,
  ktanh = 72 , kacosh = 73 , kasinh = 74 , katanh = 75 ,
  kStringEqual = 76 , kStringNotEqual = 77 , kBitAnd = 78 , kBitOr = 79 ,
  kLeftShift = 80 , kRightShift = 81 , kJumpIf = 82 , kJump = 83 ,
  kexpo = 100 , kxexpo = 100 , kyexpo = 101 , kzexpo = 102 ,
  kxyexpo = 105 , kgaus = 110 , kxgaus = 110 , kygaus = 111 ,
  kzgaus = 112 , kxygaus = 115 , klandau = 120 , kxlandau = 120 ,
  kylandau = 121 , kzlandau = 122 , kxylandau = 125 , kpol = 130 ,
  kxpol = 130 , kypol = 131 , kzpol = 132 , kParameter = 140 ,
  kConstant = 141 , kBoolOptimize = 142 , kStringConst = 143 , kVariable = 144 ,
  kFunctionCall = 145 , kData = 146 , kUnary = 147 , kBinary = 148 ,
  kThree = 149 , kDefinedVariable = 150 , kDefinedString = 151 , kPlusD = 152 ,
  kPlusDD = 153 , kMultD = 154 , kMultDD = 155 , kBoolOptimizeOr = 156 ,
  kBoolOptimizeAnd = 157 , kBoolSet = 158 , kFDM = 159 , kFD0 = 160 ,
  kFD1 = 161 , kFD2 = 162 , kFD3 = 163
}
 
typedef Double_t(TObject::* TFuncG) (const Double_t *, const Double_t *) const
 
- Protected Types inherited from TObject
enum  { kOnlyPrepStep = (1ULL << ( 3 )) }
 

Protected Member Functions

 TTreeFormula (const char *name, const char *formula, TTree *tree, const std::vector< std::string > &aliases)
 Constructor used during the expansion of an alias.
 
bool BranchHasMethod (TLeaf *leaf, TBranch *branch, const char *method, const char *params, Long64_t readentry) const
 Return the leaf (if any) of the tree with contains an object of a class having a method which has the name provided in the argument.
 
void Convert (UInt_t fromVersion) override
 
Int_t DefineAlternate (const char *expression)
 This method check for treat the case where expression contains $Atl and load up both fAliases and fExpr.
 
void DefineDimensions (Int_t code, Int_t size, TFormLeafInfoMultiVarDim *info, Int_t &virt_dim)
 This method is used internally to decode the dimensions of the variables.
 
virtual TClassEvalClass (Int_t oper) const
 Evaluate the class of the operation oper.
 
Int_t FindLeafForExpression (const char *expression, TLeaf *&leaf, TString &leftover, bool &final, UInt_t &paran_level, TObjArray &castqueue, std::vector< std::string > &aliasUsed, bool &useLeafCollectionObject, const char *fullExpression)
 Look for the leaf corresponding to the start of expression.
 
TLeafGetLeafWithDatamember (const char *topchoice, const char *nextchice, Long64_t readentry) const
 Return the leaf (if any) which contains an object containing a data member which has the name provided in the arguments.
 
Int_t GetRealInstance (Int_t instance, Int_t codeindex)
 Now let calculate what physical instance we really need.
 
virtual Double_t GetValueFromMethod (Int_t i, TLeaf *leaf) const
 Return result of a leafobject method.
 
virtual void * GetValuePointerFromMethod (Int_t i, TLeaf *leaf) const
 Return result of a leafobject method.
 
void Init (const char *name, const char *formula)
 Initialization called from the constructors.
 
virtual bool IsLeafInteger (Int_t code) const
 Return TRUE if the leaf corresponding to code is short, int or unsigned short, int When a leaf is of type integer, the generated histogram is forced to have an integer bin width.
 
virtual bool IsLeafString (Int_t code) const
 Return TRUE if the leaf or data member corresponding to code is a string.
 
bool IsString (Int_t oper) const override
 Return true if the expression at the index 'oper' is to be treated as as string.
 
void LoadBranches ()
 Make sure that all the branches have been loaded properly.
 
bool LoadCurrentDim ()
 Calculate the actual dimension for the current entry.
 
Int_t ParseWithLeaf (TLeaf *leaf, const char *expression, bool final, UInt_t paran_level, TObjArray &castqueue, bool useLeafCollectionObject, const char *fullExpression)
 Decompose 'expression' as pointing to something inside the leaf Returns:
 
Int_t RegisterDimensions (const char *size, Int_t code)
 This method is used internally to decode the dimensions of the variables.
 
Int_t RegisterDimensions (Int_t code, Int_t size, TFormLeafInfoMultiVarDim *multidim=nullptr)
 This method stores the dimension information for later usage.
 
Int_t RegisterDimensions (Int_t code, TBranchElement *branch)
 This method is used internally to decode the dimensions of the variables.
 
Int_t RegisterDimensions (Int_t code, TFormLeafInfo *info, TFormLeafInfo *maininfo, bool useCollectionObject)
 This method is used internally to decode the dimensions of the variables.
 
Int_t RegisterDimensions (Int_t code, TLeaf *leaf)
 This method is used internally to decode the dimensions of the variables.
 
void ResetDimensions ()
 Populate the TTreeFormulaManager with the dimension information.
 
bool StringToNumber (Int_t code) override
 Try to 'demote' a string into an array bytes.
 
virtual bool SwitchToFormLeafInfo (Int_t code)
 Convert the underlying lookup method from the direct technique (dereferencing the address held by the branch) to the method using TFormLeafInfo.
 
- Protected Member Functions inherited from ROOT::v5::TFormula
virtual Bool_t CheckOperands (Int_t leftoperand, Int_t rightoperartion, Int_t &err)
 Check whether the operands at 'leftoper' and 'oper-1' are compatible with the operation at 'oper'.
 
virtual Bool_t CheckOperands (Int_t operation, Int_t &err)
 Check whether the operand at 'oper-1' is compatible with the operation at 'oper'.
 
void ClearFormula (Option_t *option="")
 Resets the objects.
 
Double_t EvalParFast (const Double_t *x, const Double_t *params)
 Evaluate this formula.
 
Double_t EvalPrimitive (const Double_t *x, const Double_t *params)
 Evaluate primitive formula.
 
Double_t EvalPrimitive0 (const Double_t *x, const Double_t *params)
 Evaluate primitive formula.
 
Double_t EvalPrimitive1 (const Double_t *x, const Double_t *params)
 Evaluate primitive formula.
 
Double_t EvalPrimitive2 (const Double_t *x, const Double_t *params)
 Evaluate primitive formula.
 
Double_t EvalPrimitive3 (const Double_t *x, const Double_t *params)
 Evaluate primitive formula.
 
Double_t EvalPrimitive4 (const Double_t *x, const Double_t *params)
 Evaluate primitive formula.
 
Short_t GetAction (Int_t code) const
 
Short_t GetActionOptimized (Int_t code) const
 
Int_t GetActionParam (Int_t code) const
 
Int_t GetActionParamOptimized (Int_t code) const
 
Int_tGetOper () const
 
Int_tGetOperOptimized () const
 
void MakePrimitive (const char *expr, Int_t pos)
 MakePrimitive find TFormulaPrimitive replacement for some operands.
 
Int_t PreCompile ()
 pointer to optimal function
 
void SetAction (Int_t code, Int_t value, Int_t param=0)
 
void SetActionOptimized (Int_t code, Int_t value, Int_t param=0)
 
- Protected Member Functions inherited from TObject
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected).
 
void MakeZombie ()
 

Protected Attributes

TObjArray fAliases
 ! List of TTreeFormula for each alias used.
 
std::vector< std::string > fAliasesUsed
 ! List of aliases used during the parsing of the expression.
 
TAxisfAxis
 ! pointer to histogram axis if this is a string
 
TObjArray fBranches
 ! List of branches to read. Similar to fLeaves but duplicates are zeroed out.
 
Int_t fCodes [kMAXCODES]
 List of leaf numbers referenced in formula.
 
LongDouble_tfConstLD
 ! local version of fConsts able to store bigger numbers
 
Int_t fCumulSizes [kMAXCODES][kMAXFORMDIM]
 Accumulated sizes of lower dimensions for each leaf after variable dimensions has been calculated.
 
TObjArray fDataMembers
 ! List of leaf data members
 
bool fDidBooleanOptimization
 ! True if we executed one boolean optimization since the last time instance number 0 was evaluated
 
TListfDimensionSetup
 ! list of dimension setups, for delayed creation of the dimension information.
 
TObjArray fExternalCuts
 ! List of TCutG and TEntryList used in the formula
 
Int_t fFixedSizes [kMAXCODES][kMAXFORMDIM]
 Physical sizes of lower dimensions for each leaf.
 
bool fHasCast
 Record whether the formula contain a cast operation or not.
 
UChar_t fHasMultipleVarDim [kMAXCODES]
 True if the corresponding variable is an array with more than one variable dimension.
 
Int_t fIndexes [kMAXCODES][kMAXFORMDIM]
 Index of array selected by user for each leaf.
 
TObjArray fLeafNames
 List of TNamed describing leaves.
 
TObjArray fLeaves
 ! List of leaf used in this formula.
 
Int_tfLookupType
 [fNindex] Array indicating how each leaf should be looked-up
 
TTreeFormulaManagerfManager
 ! The dimension coordinator.
 
TObjArray fMethods
 ! List of leaf method calls
 
Int_t fMultiplicity
 Indicator of the variability of the formula.
 
Int_t fNcodes
 Number of leaves referenced in formula.
 
Int_t fNdata [kMAXCODES]
 ! This caches the physical number of element in the leaf or data member.
 
Int_t fNdimensions [kMAXCODES]
 Number of array dimensions in each leaf.
 
bool fNeedLoading
 ! If true, the current entry has not been loaded yet.
 
Int_t fNindex
 Size of fIndex.
 
bool fQuickLoad
 ! If true, branch GetEntry is only called when the entry number changes.
 
RealInstanceCache fRealInstanceCache
 ! Cache accelerating the GetRealInstance function
 
TTreefTree
 ! Pointer to Tree
 
TTreeFormulafVarIndexes [kMAXCODES][kMAXFORMDIM]
 Pointer to a variable index.
 
- Protected Attributes inherited from ROOT::v5::TFormula
TBits fAlreadyFound
 
Double_tfConst
 
TStringfExpr
 
TStringfExprOptimized
 Number of operators after optimization.
 
TObjArray fFunctions
 
TObjArray fLinearParts
 
TStringfNames
 
Int_t fNconst
 
Int_t fNdim
 
Int_t fNoper
 
Int_t fNOperOptimized
 cache for information
 
Int_t fNpar
 
Int_t fNstring
 
Int_t fNumber
 
Int_t fNval
 
TOperOffsetfOperOffset
 [fNOperOptimized] List of operators. (See documentation for changes made at version 7)
 
Int_tfOperOptimized
 [fNOperOptimized] List of expressions
 
TFuncG fOptimal
 [fNPar] predefined function
 
Double_tfParams
 
TFormulaPrimitive ** fPredefined
 [fNOperOptimized] Offsets of operrands
 
- Protected Attributes inherited from TNamed
TString fName
 
TString fTitle
 

Private Member Functions

 TTreeFormula (const TTreeFormula &)=delete
 
template<typename T >
GetConstant (Int_t k)
 
TTreeFormulaoperator= (const TTreeFormula &)=delete
 

Friends

class TTreeFormulaManager
 

Additional Inherited Members

- Public Types inherited from ROOT::v5::TFormula
enum  { kNotGlobal = (1ULL << ( 10 )) , kNormalized = (1ULL << ( 14 )) , kLinear = (1ULL << ( 16 )) }
 
- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) }
 
enum  EStatusBits {
  kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) ,
  kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 ))
}
 

#include <TTreeFormula.h>

Inheritance diagram for TTreeFormula:
[legend]

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
protected
Enumerator
kDirect 
kDataMember 
kMethod 
kIndexOfEntry 
kEntries 
kLength 
kIteration 
kLengthFunc 
kSum 
kEntryList 
kTreeMember 
kIndexOfLocalEntry 
kMin 
kMax 
kLocalEntries 

Definition at line 69 of file TTreeFormula.h.

◆ anonymous enum

anonymous enum
protected
Enumerator
kAlias 
kAliasString 
kAlternate 
kAlternateString 
kMinIf 
kMaxIf 

Definition at line 78 of file TTreeFormula.h.

◆ EStatusBits

enum TTreeFormula::EStatusBits
protected
Enumerator
kIsCharacter 
kMissingLeaf 
kIsInteger 
kNeedEntries 

Definition at line 63 of file TTreeFormula.h.

Constructor & Destructor Documentation

◆ TTreeFormula() [1/4]

TTreeFormula::TTreeFormula ( const char *  name,
const char *  formula,
TTree tree,
const std::vector< std::string > &  aliases 
)
protected

Constructor used during the expansion of an alias.

Definition at line 167 of file TTreeFormula.cxx.

◆ TTreeFormula() [2/4]

TTreeFormula::TTreeFormula ( const TTreeFormula )
privatedelete

◆ TTreeFormula() [3/4]

TTreeFormula::TTreeFormula ( )

Definition at line 124 of file TTreeFormula.cxx.

◆ TTreeFormula() [4/4]

TTreeFormula::TTreeFormula ( const char *  name,
const char *  formula,
TTree tree 
)

Normal TTree Formula Constructor.

Definition at line 157 of file TTreeFormula.cxx.

◆ ~TTreeFormula()

TTreeFormula::~TTreeFormula ( )
override

Tree Formula default destructor.

Definition at line 324 of file TTreeFormula.cxx.

Member Function Documentation

◆ BranchHasMethod()

bool TTreeFormula::BranchHasMethod ( TLeaf leaf,
TBranch branch,
const char *  method,
const char *  params,
Long64_t  readentry 
) const
protected

Return the leaf (if any) of the tree with contains an object of a class having a method which has the name provided in the argument.

Definition at line 3243 of file TTreeFormula.cxx.

◆ Class()

static TClass * TTreeFormula::Class ( )
static
Returns
TClass describing this class

◆ Class_Name()

static const char * TTreeFormula::Class_Name ( )
static
Returns
Name of this class

◆ Class_Version()

static constexpr Version_t TTreeFormula::Class_Version ( )
inlinestaticconstexpr
Returns
Version of this class

Definition at line 216 of file TTreeFormula.h.

◆ Convert()

void TTreeFormula::Convert ( UInt_t  fromVersion)
overrideprotectedvirtual

Reimplemented from ROOT::v5::TFormula.

Definition at line 5666 of file TTreeFormula.cxx.

◆ DeclFileName()

static const char * TTreeFormula::DeclFileName ( )
inlinestatic
Returns
Name of the file containing the class declaration

Definition at line 216 of file TTreeFormula.h.

◆ DefineAlternate()

Int_t TTreeFormula::DefineAlternate ( const char *  expression)
protected

This method check for treat the case where expression contains $Atl and load up both fAliases and fExpr.

We return:

  • -1 in case of failure
  • 0 in case we did not find $Alt
  • the action number in case of success.

Definition at line 657 of file TTreeFormula.cxx.

◆ DefineDimensions()

void TTreeFormula::DefineDimensions ( Int_t  code,
Int_t  size,
TFormLeafInfoMultiVarDim info,
Int_t virt_dim 
)
protected

This method is used internally to decode the dimensions of the variables.

Definition at line 356 of file TTreeFormula.cxx.

◆ DefinedVariable()

Int_t TTreeFormula::DefinedVariable ( TString name,
Int_t action 
)
overridevirtual

Check if name is in the list of Tree/Branch leaves.

This member function redefines the function in ROOT::v5::TFormula If a leaf has a name corresponding to the argument name, then returns a new code.

A TTreeFormula may contain more than one variable. For each variable referenced, the pointers to the corresponding branch and leaf is stored in the object arrays fBranches and fLeaves.

name can be :

  • Leaf_Name (simple variable or data member of a ClonesArray)
  • Branch_Name.Leaf_Name
  • Branch_Name.Method_Name
  • Leaf_Name[index]
  • Branch_Name.Leaf_Name[index]
  • Branch_Name.Leaf_Name[index1]
  • Branch_Name.Leaf_Name[][index2]
  • Branch_Name.Leaf_Name[index1][index2]

New additions:

  • Branch_Name.Leaf_Name[OtherLeaf_Name]
  • Branch_Name.Datamember_Name
  • '.' can be replaced by '->'

    and

  • Branch_Name[index1].Leaf_Name[index2]
  • Leaf_name[index].Action().OtherAction(param)
  • Leaf_name[index].Action()[val].OtherAction(param)

The expected returned values are

  • -2 : the name has been recognized but won't be usable
  • -1 : the name has not been recognized, or is too long, or tree does not exist.
  • >=0 : the name has been recognized, return the internal code for this name.

Reimplemented from ROOT::v5::TFormula.

Definition at line 2698 of file TTreeFormula.cxx.

◆ EvalClass() [1/2]

TClass * TTreeFormula::EvalClass ( ) const
virtual

Evaluate the class of this treeformula.

If the 'value' of this formula is a simple pointer to an object, this function returns the TClass corresponding to its type.

Definition at line 3597 of file TTreeFormula.cxx.

◆ EvalClass() [2/2]

TClass * TTreeFormula::EvalClass ( Int_t  oper) const
protectedvirtual

Evaluate the class of the operation oper.

If the 'value' in the requested operation is a simple pointer to an object, this function returns the TClass corresponding to its type.

Definition at line 3610 of file TTreeFormula.cxx.

◆ EvalInstance() [1/2]

template<typename T >
T TTreeFormula::EvalInstance ( Int_t  instance = 0,
const char *  stringStackArg[] = nullptr 
)

Evaluate this treeformula.

Template Parameters
TThe type used to interpret the numbers then used for the operations
Parameters
instanceiteration instance
stringStackArgformula as string
Returns
the result of the evaluation

Definition at line 3977 of file TTreeFormula.cxx.

◆ EvalInstance() [2/2]

virtual Double_t TTreeFormula::EvalInstance ( Int_t  i = 0,
const char *  stringStack[] = nullptr 
)
inlinevirtual

Double_t template specialization of EvalInstance.

Definition at line 182 of file TTreeFormula.h.

◆ EvalInstance64()

virtual Long64_t TTreeFormula::EvalInstance64 ( Int_t  i = 0,
const char *  stringStack[] = nullptr 
)
inlinevirtual

Long64_t template specialization of EvalInstance.

Definition at line 184 of file TTreeFormula.h.

◆ EvalInstanceLD()

virtual LongDouble_t TTreeFormula::EvalInstanceLD ( Int_t  i = 0,
const char *  stringStack[] = nullptr 
)
inlinevirtual

LongDouble_t template specialization of EvalInstance.

Definition at line 186 of file TTreeFormula.h.

◆ EvalObject()

void * TTreeFormula::EvalObject ( Int_t  i = 0)
virtual

Evaluate this treeformula.

Return the address of the object pointed to by the formula. Return 0 if the formula is not a single object The object type can be retrieved using by call EvalClass();

Definition at line 3659 of file TTreeFormula.cxx.

◆ EvalStringInstance()

const char * TTreeFormula::EvalStringInstance ( Int_t  i = 0)
virtual

Eval the instance as a string.

Definition at line 3710 of file TTreeFormula.cxx.

◆ FindLeafForExpression()

Int_t TTreeFormula::FindLeafForExpression ( const char *  expression,
TLeaf *&  leaf,
TString leftover,
bool final,
UInt_t paran_level,
TObjArray castqueue,
std::vector< std::string > &  aliasUsed,
bool useLeafCollectionObject,
const char *  fullExpression 
)
protected

Look for the leaf corresponding to the start of expression.

It returns the corresponding leaf if any. It also modify the following arguments:

  • leftover: contain from expression that was not used to determine the leaf
  • final:
    • paran_level: number of un-matched open parenthesis
    • cast_queue: list of cast to be done
    • aliases: list of aliases used
  • Return <0 in case of failure
  • Return 0 if a leaf has been found
  • Return 2 if info about the TTree itself has been requested.

Definition at line 2188 of file TTreeFormula.cxx.

◆ GetConstant() [1/2]

template<typename T >
T TTreeFormula::GetConstant ( Int_t  k)
inlineprivate

Definition at line 3946 of file TTreeFormula.cxx.

◆ GetConstant() [2/2]

template<>
Long64_t TTreeFormula::GetConstant ( Int_t  k)
inline

Definition at line 3947 of file TTreeFormula.cxx.

◆ GetLeaf()

TLeaf * TTreeFormula::GetLeaf ( Int_t  n) const
virtual

Return leaf corresponding to serial number n.

Definition at line 4465 of file TTreeFormula.cxx.

◆ GetLeafInfo()

TFormLeafInfo * TTreeFormula::GetLeafInfo ( Int_t  code) const

Return DataMember corresponding to code.

function called by TLeafObject::GetValue with the value of fLookupType computed in TTreeFormula::DefinedVariable

Definition at line 4456 of file TTreeFormula.cxx.

◆ GetLeafWithDatamember()

TLeaf * TTreeFormula::GetLeafWithDatamember ( const char *  topchoice,
const char *  nextchice,
Long64_t  readentry 
) const
protected

Return the leaf (if any) which contains an object containing a data member which has the name provided in the arguments.

Definition at line 3077 of file TTreeFormula.cxx.

◆ GetManager()

TTreeFormulaManager * TTreeFormula::GetManager ( ) const
inline

Definition at line 192 of file TTreeFormula.h.

◆ GetMethodCall()

TMethodCall * TTreeFormula::GetMethodCall ( Int_t  code) const

Return methodcall corresponding to code.

function called by TLeafObject::GetValue with the value of fLookupType computed in TTreeFormula::DefinedVariable

Definition at line 4476 of file TTreeFormula.cxx.

◆ GetMultiplicity()

virtual Int_t TTreeFormula::GetMultiplicity ( ) const
inlinevirtual

Definition at line 194 of file TTreeFormula.h.

◆ GetNcodes()

virtual Int_t TTreeFormula::GetNcodes ( ) const
inlinevirtual

Definition at line 196 of file TTreeFormula.h.

◆ GetNdata()

Int_t TTreeFormula::GetNdata ( )
virtual

Return number of available instances in the formula.

Definition at line 4485 of file TTreeFormula.cxx.

◆ GetRealInstance()

Int_t TTreeFormula::GetRealInstance ( Int_t  instance,
Int_t  codeindex 
)
protected

Now let calculate what physical instance we really need.

Some redundant code is used to speed up the cases where they are no dimensions.

We know that instance is less that fCumulUsedSize[0] so we can skip the modulo when virt_dim is 0.

Definition at line 3362 of file TTreeFormula.cxx.

◆ GetTree()

virtual TTree * TTreeFormula::GetTree ( ) const
inlinevirtual

Definition at line 213 of file TTreeFormula.h.

◆ GetValueFromMethod()

Double_t TTreeFormula::GetValueFromMethod ( Int_t  i,
TLeaf leaf 
) const
protectedvirtual

Return result of a leafobject method.

Definition at line 4493 of file TTreeFormula.cxx.

◆ GetValuePointerFromMethod()

void * TTreeFormula::GetValuePointerFromMethod ( Int_t  i,
TLeaf leaf 
) const
protectedvirtual

Return result of a leafobject method.

Definition at line 4554 of file TTreeFormula.cxx.

◆ Init()

void TTreeFormula::Init ( const char *  name,
const char *  formula 
)
protected

Initialization called from the constructors.

Definition at line 178 of file TTreeFormula.cxx.

◆ IsA()

TClass * TTreeFormula::IsA ( ) const
inlineoverridevirtual
Returns
TClass describing current object

Reimplemented from ROOT::v5::TFormula.

Definition at line 216 of file TTreeFormula.h.

◆ IsInteger()

bool TTreeFormula::IsInteger ( bool  fast = true) const
virtual

Return TRUE if the formula corresponds to one single Tree leaf and this leaf is short, int or unsigned short, int When a leaf is of type integer or string, the generated histogram is forced to have an integer bin width.

Definition at line 4623 of file TTreeFormula.cxx.

◆ IsLeafInteger()

bool TTreeFormula::IsLeafInteger ( Int_t  code) const
protectedvirtual

Return TRUE if the leaf corresponding to code is short, int or unsigned short, int When a leaf is of type integer, the generated histogram is forced to have an integer bin width.

Definition at line 4678 of file TTreeFormula.cxx.

◆ IsLeafString()

bool TTreeFormula::IsLeafString ( Int_t  code) const
protectedvirtual

Return TRUE if the leaf or data member corresponding to code is a string.

Definition at line 4748 of file TTreeFormula.cxx.

◆ IsQuickLoad()

bool TTreeFormula::IsQuickLoad ( ) const
inline

Definition at line 204 of file TTreeFormula.h.

◆ IsString() [1/2]

bool TTreeFormula::IsString ( ) const
virtual

Return TRUE if the formula is a string.

Definition at line 4726 of file TTreeFormula.cxx.

◆ IsString() [2/2]

bool TTreeFormula::IsString ( Int_t  oper) const
overrideprotectedvirtual

Return true if the expression at the index 'oper' is to be treated as as string.

Reimplemented from ROOT::v5::TFormula.

Definition at line 4736 of file TTreeFormula.cxx.

◆ LoadBranches()

void TTreeFormula::LoadBranches ( )
protected

Make sure that all the branches have been loaded properly.

Definition at line 5369 of file TTreeFormula.cxx.

◆ LoadCurrentDim()

bool TTreeFormula::LoadCurrentDim ( )
protected

Calculate the actual dimension for the current entry.

Definition at line 5393 of file TTreeFormula.cxx.

◆ Notify()

bool TTreeFormula::Notify ( )
inlineoverridevirtual

This method must be overridden to handle object notification (the base implementation is no-op).

Different objects in ROOT use the Notify method for different purposes, in coordination with other objects that call this method at the appropriate time.

For example, TLeaf uses it to load class information; TBranchRef to load contents of referenced branches TBranchRef; most notably, based on Notify, TChain implements a callback mechanism to inform interested parties when it switches to a new sub-tree.

Reimplemented from TObject.

Definition at line 206 of file TTreeFormula.h.

◆ operator=()

TTreeFormula & TTreeFormula::operator= ( const TTreeFormula )
privatedelete

◆ ParseWithLeaf()

Int_t TTreeFormula::ParseWithLeaf ( TLeaf leaf,
const char *  subExpression,
bool  final,
UInt_t  paran_level,
TObjArray castqueue,
bool  useLeafCollectionObject,
const char *  fullExpression 
)
protected

Decompose 'expression' as pointing to something inside the leaf Returns:

  • -2 Error: some information is missing (message already printed)
  • -1 Error: Syntax is incorrect (message already printed)
  • 0
  • >0 the value returns is the action code.

Definition at line 764 of file TTreeFormula.cxx.

◆ PrintValue() [1/2]

char * TTreeFormula::PrintValue ( Int_t  mode,
Int_t  instance,
const char *  decform = "9.9" 
) const
virtual

Return value of variable as a string.

  • mode = -2 : Print line with ***
  • mode = -1 : Print column names
  • mode = 0 : Print column values

    decform contains the requested format (with the same convention as printf).

Definition at line 4840 of file TTreeFormula.cxx.

◆ PrintValue() [2/2]

char * TTreeFormula::PrintValue ( Int_t  mode = 0) const
virtual

Return value of variable as a string.

  • mode = -2 : Print line with ***
  • mode = -1 : Print column names
  • mode = 0 : Print column values

Definition at line 4826 of file TTreeFormula.cxx.

◆ RegisterDimensions() [1/5]

Int_t TTreeFormula::RegisterDimensions ( const char *  size,
Int_t  code 
)
protected

This method is used internally to decode the dimensions of the variables.

Definition at line 402 of file TTreeFormula.cxx.

◆ RegisterDimensions() [2/5]

Int_t TTreeFormula::RegisterDimensions ( Int_t  code,
Int_t  size,
TFormLeafInfoMultiVarDim multidim = nullptr 
)
protected

This method stores the dimension information for later usage.

Definition at line 439 of file TTreeFormula.cxx.

◆ RegisterDimensions() [3/5]

Int_t TTreeFormula::RegisterDimensions ( Int_t  code,
TBranchElement branch 
)
protected

This method is used internally to decode the dimensions of the variables.

Definition at line 555 of file TTreeFormula.cxx.

◆ RegisterDimensions() [4/5]

Int_t TTreeFormula::RegisterDimensions ( Int_t  code,
TFormLeafInfo info,
TFormLeafInfo maininfo,
bool  useCollectionObject 
)
protected

This method is used internally to decode the dimensions of the variables.

Definition at line 450 of file TTreeFormula.cxx.

◆ RegisterDimensions() [5/5]

Int_t TTreeFormula::RegisterDimensions ( Int_t  code,
TLeaf leaf 
)
protected

This method is used internally to decode the dimensions of the variables.

Definition at line 583 of file TTreeFormula.cxx.

◆ ResetDimensions()

void TTreeFormula::ResetDimensions ( )
protected

Populate the TTreeFormulaManager with the dimension information.

Definition at line 5187 of file TTreeFormula.cxx.

◆ ResetLoading()

void TTreeFormula::ResetLoading ( )
virtual

Tell the formula that we are going to request a new entry.

Definition at line 4981 of file TTreeFormula.cxx.

◆ SetAxis()

void TTreeFormula::SetAxis ( TAxis axis = nullptr)
virtual

Set the axis (in particular get the type).

Definition at line 5019 of file TTreeFormula.cxx.

◆ SetQuickLoad()

void TTreeFormula::SetQuickLoad ( bool  quick)
inline

Definition at line 210 of file TTreeFormula.h.

◆ SetTree()

virtual void TTreeFormula::SetTree ( TTree tree)
inlinevirtual

Definition at line 211 of file TTreeFormula.h.

◆ Streamer()

void TTreeFormula::Streamer ( TBuffer R__b)
overridevirtual

Stream an object of class TTreeFormula.

Reimplemented from ROOT::v5::TFormula.

Definition at line 5044 of file TTreeFormula.cxx.

◆ StreamerNVirtual()

void TTreeFormula::StreamerNVirtual ( TBuffer ClassDef_StreamerNVirtual_b)
inline

Definition at line 216 of file TTreeFormula.h.

◆ StringToNumber()

bool TTreeFormula::StringToNumber ( Int_t  oper)
overrideprotectedvirtual

Try to 'demote' a string into an array bytes.

If this is not possible, return false.

Reimplemented from ROOT::v5::TFormula.

Definition at line 5078 of file TTreeFormula.cxx.

◆ SwitchToFormLeafInfo()

bool TTreeFormula::SwitchToFormLeafInfo ( Int_t  code)
protectedvirtual

Convert the underlying lookup method from the direct technique (dereferencing the address held by the branch) to the method using TFormLeafInfo.

This is in particular useful in the case where we need to append an additional TFormLeafInfo (for example to call a method). Return false if the switch was unsuccessful (basically in the case of an old style split tree).

Definition at line 5714 of file TTreeFormula.cxx.

◆ UpdateFormulaLeaves()

void TTreeFormula::UpdateFormulaLeaves ( )
virtual

This function is called TTreePlayer::UpdateFormulaLeaves, itself called by TChain::LoadTree when a new Tree is loaded.

Because Trees in a TChain may have a different list of leaves, one must update the leaves numbers in the TTreeFormula used by the TreePlayer.

A safer alternative would be to recompile the whole thing .... However currently compile HAS TO be called from the constructor!

Definition at line 5107 of file TTreeFormula.cxx.

Friends And Related Symbol Documentation

◆ TTreeFormulaManager

friend class TTreeFormulaManager
friend

Definition at line 60 of file TTreeFormula.h.

Member Data Documentation

◆ fAliases

TObjArray TTreeFormula::fAliases
protected

! List of TTreeFormula for each alias used.

Definition at line 107 of file TTreeFormula.h.

◆ fAliasesUsed

std::vector<std::string> TTreeFormula::fAliasesUsed
protected

! List of aliases used during the parsing of the expression.

Definition at line 128 of file TTreeFormula.h.

◆ fAxis

TAxis* TTreeFormula::fAxis
protected

! pointer to histogram axis if this is a string

Definition at line 122 of file TTreeFormula.h.

◆ fBranches

TObjArray TTreeFormula::fBranches
protected

! List of branches to read. Similar to fLeaves but duplicates are zeroed out.

Definition at line 109 of file TTreeFormula.h.

◆ fCodes

Int_t TTreeFormula::fCodes[kMAXCODES]
protected

List of leaf numbers referenced in formula.

Definition at line 96 of file TTreeFormula.h.

◆ fConstLD

LongDouble_t* TTreeFormula::fConstLD
protected

! local version of fConsts able to store bigger numbers

Definition at line 130 of file TTreeFormula.h.

◆ fCumulSizes

Int_t TTreeFormula::fCumulSizes[kMAXCODES][kMAXFORMDIM]
protected

Accumulated sizes of lower dimensions for each leaf after variable dimensions has been calculated.

Definition at line 118 of file TTreeFormula.h.

◆ fDataMembers

TObjArray TTreeFormula::fDataMembers
protected

! List of leaf data members

Definition at line 104 of file TTreeFormula.h.

◆ fDidBooleanOptimization

bool TTreeFormula::fDidBooleanOptimization
protected

! True if we executed one boolean optimization since the last time instance number 0 was evaluated

Definition at line 123 of file TTreeFormula.h.

◆ fDimensionSetup

TList* TTreeFormula::fDimensionSetup
protected

! list of dimension setups, for delayed creation of the dimension information.

Definition at line 127 of file TTreeFormula.h.

◆ fExternalCuts

TObjArray TTreeFormula::fExternalCuts
protected

! List of TCutG and TEntryList used in the formula

Definition at line 106 of file TTreeFormula.h.

◆ fFixedSizes

Int_t TTreeFormula::fFixedSizes[kMAXCODES][kMAXFORMDIM]
protected

Physical sizes of lower dimensions for each leaf.

Definition at line 114 of file TTreeFormula.h.

◆ fHasCast

bool TTreeFormula::fHasCast
protected

Record whether the formula contain a cast operation or not.

Definition at line 99 of file TTreeFormula.h.

◆ fHasMultipleVarDim

UChar_t TTreeFormula::fHasMultipleVarDim[kMAXCODES]
protected

True if the corresponding variable is an array with more than one variable dimension.

Definition at line 115 of file TTreeFormula.h.

◆ fIndexes

Int_t TTreeFormula::fIndexes[kMAXCODES][kMAXFORMDIM]
protected

Index of array selected by user for each leaf.

Definition at line 119 of file TTreeFormula.h.

◆ fLeafNames

TObjArray TTreeFormula::fLeafNames
protected

List of TNamed describing leaves.

Definition at line 108 of file TTreeFormula.h.

◆ fLeaves

TObjArray TTreeFormula::fLeaves
protected

! List of leaf used in this formula.

Definition at line 103 of file TTreeFormula.h.

◆ fLookupType

Int_t* TTreeFormula::fLookupType
protected

[fNindex] Array indicating how each leaf should be looked-up

Definition at line 102 of file TTreeFormula.h.

◆ fManager

TTreeFormulaManager* TTreeFormula::fManager
protected

! The dimension coordinator.

Definition at line 124 of file TTreeFormula.h.

◆ fMethods

TObjArray TTreeFormula::fMethods
protected

! List of leaf method calls

Definition at line 105 of file TTreeFormula.h.

◆ fMultiplicity

Int_t TTreeFormula::fMultiplicity
protected

Indicator of the variability of the formula.

Definition at line 100 of file TTreeFormula.h.

◆ fNcodes

Int_t TTreeFormula::fNcodes
protected

Number of leaves referenced in formula.

Definition at line 98 of file TTreeFormula.h.

◆ fNdata

Int_t TTreeFormula::fNdata[kMAXCODES]
protected

! This caches the physical number of element in the leaf or data member.

Definition at line 97 of file TTreeFormula.h.

◆ fNdimensions

Int_t TTreeFormula::fNdimensions[kMAXCODES]
protected

Number of array dimensions in each leaf.

Definition at line 113 of file TTreeFormula.h.

◆ fNeedLoading

bool TTreeFormula::fNeedLoading
protected

! If true, the current entry has not been loaded yet.

Definition at line 111 of file TTreeFormula.h.

◆ fNindex

Int_t TTreeFormula::fNindex
protected

Size of fIndex.

Definition at line 101 of file TTreeFormula.h.

◆ fQuickLoad

bool TTreeFormula::fQuickLoad
protected

! If true, branch GetEntry is only called when the entry number changes.

Definition at line 110 of file TTreeFormula.h.

◆ fRealInstanceCache

RealInstanceCache TTreeFormula::fRealInstanceCache
protected

! Cache accelerating the GetRealInstance function

Definition at line 132 of file TTreeFormula.h.

◆ fTree

TTree* TTreeFormula::fTree
protected

! Pointer to Tree

Definition at line 95 of file TTreeFormula.h.

◆ fVarIndexes

TTreeFormula* TTreeFormula::fVarIndexes[kMAXCODES][kMAXFORMDIM]
protected

Pointer to a variable index.

Definition at line 120 of file TTreeFormula.h.

Libraries for TTreeFormula:

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