1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
7 * Permission to use, copy, modify and distribute this software and its *
8 * documentation strictly for non-commercial purposes is hereby granted *
9 * without fee, provided that the above copyright notice appears in all *
10 * copies and that both the copyright notice and this permission notice *
11 * appear in the supporting documentation. The authors make no claims *
12 * about the suitability of this software for any purpose. It is *
13 * provided "as is" without express or implied warranty. *
14 **************************************************************************/
17 // Author: Andrei Gheata, 31/05/2006
19 //==============================================================================
20 // AliAnalysysDataSlot - Class representing a data slot of an analysis task.
21 // An analysis slot enforces a certain data type required by the Exec()
22 // method of the analysis task. The slot must be connected to a data
23 // container with data of the same type.
25 // The class should not be directly created by users - it is created by
26 // each AliAnalysisTask when defining its input/output slots using:
28 // AliAnalysisTask::SetInput(Int_t index, TClass *type);
29 // AliAnalysisTask::SetOutput(TClass *type);
31 // An existing data contaner (AliAnalysisDataContainer) can be connected to the
32 // input/output slots of an analysis task using:
34 // AliAnalysisModule::ConnectInput(AliAnalysisTask *task, Int_t islot,
35 // AliAnalysisDataContainer *cont)
36 // AliAnalysisModule::ConnectOutput(AliAnalysisTask *task,
37 // AliAnalysisDataContainer *cont)
38 // To connect a slot to a data container, the data types declared by both must
40 //==============================================================================
42 #include <Riostream.h>
48 #include "AliAnalysisDataSlot.h"
49 #include "AliAnalysisTask.h"
50 #include "AliAnalysisDataContainer.h"
54 ClassImp(AliAnalysisDataSlot)
56 //______________________________________________________________________________
57 AliAnalysisDataSlot::AliAnalysisDataSlot(TClass *type, AliAnalysisTask *task)
63 // Default constructor.
64 SetTitle(fType->GetName());
67 //______________________________________________________________________________
68 AliAnalysisDataSlot::AliAnalysisDataSlot(const AliAnalysisDataSlot &slot)
71 fParent(slot.fParent),
72 fContainer(slot.fContainer)
78 //______________________________________________________________________________
79 AliAnalysisDataSlot& AliAnalysisDataSlot::operator=(const AliAnalysisDataSlot &slot)
82 if (&slot == this) return *this;
83 TNamed::operator=(slot);
85 fParent = slot.fParent;
86 fContainer = slot.fContainer;
90 //______________________________________________________________________________
91 Bool_t AliAnalysisDataSlot::ConnectContainer(AliAnalysisDataContainer *cont)
93 // Connect the data slot with a given container. The operation will succeed only
94 // if the type defined by the slot inherits from the type enforced by the container.
95 // The error message in case of failure is posted by the caller.
96 if (!cont || !GetType()) return kFALSE;
97 if (!fType->InheritsFrom(cont->GetType())) {
98 cout<<"Data slot of type "<<GetTitle()<<" of task "<<fParent->GetName()<<" cannot be connected to data container "<<cont->GetName()<<" of type "<<cont->GetTitle()<<endl;
99 //AliError(Form("Data slot of type %s of task %s cannot be connected to data container %s of type %s", fType->GetName(), fParent->GetName(), cont->GetName(), cont->GetType()->GetName()));
106 //______________________________________________________________________________
107 TClass *AliAnalysisDataSlot::GetType() const
109 // Get class type for this slot.
110 AliAnalysisDataSlot *slot = (AliAnalysisDataSlot*)this;
111 if (!fType) slot->SetType(gROOT->GetClass(fTitle.Data()));
112 if (!fType) printf("AliAnalysisDataSlot: Unknown class: %s\n", GetTitle());
116 //______________________________________________________________________________
117 void *AliAnalysisDataSlot::GetBranchAddress(const char *branchname) const
119 // Retrieve the address for a given branch. One should always test this before
120 // using SetBranchAddress because the address gets set by the first caller.
121 // Call this in MyTask::Init()
122 if (!GetType()) return NULL;
123 if (!fType->InheritsFrom(TTree::Class())) {
124 cout<<"Cannot call GetBranchAddress() for data slot of task "<<fParent->GetName()<<" not pointing to tree-type data"<<endl;
125 //AliFatal(Form("Cannot call GetBranchAddress() for data slot of task %s not pointing to tree-type data", fParent->GetName()));
128 if (!IsDataReady()) {
129 cout<<"Cannot call GetBranchAddress() for data slot of task "<<fParent->GetName()<<" while data is not ready"<<endl;
130 //AliFatal(Form("Cannot call GetBranchAddress() for data slot of task %s while data is not ready", fParent->GetName()));
133 TTree *tree = (TTree*)GetData();
134 TBranch *br = tree->GetBranch(branchname);
136 cout<<"Branch "<<branchname<<" not found in tree "<<tree->GetName()<<" as input of task "<<fParent->GetName()<<"..."<<endl;
137 //AliFatal(Form("Branch %s not found in tree %s as input of task %s...", branchname, tree->GetName(), fParent->GetName()));
140 return br->GetAddress();
143 //______________________________________________________________________________
144 Int_t AliAnalysisDataSlot::EnableBranch(const char *bname, TTree *tree)
146 // Static method to enable recursively a branch in a tree (why this in not in ROOT?)
147 TBranch *branch = tree->GetBranch(bname);
149 // static Int_t indent = 0;
150 if (!branch) return count;
152 // for (Int_t i=0; i<indent; i++) s += " ";
154 // printf("%sbranch %s: kDoNotProcess=%d\n",s.Data(), branch->GetName(), branch->TestBit(kDoNotProcess));
155 branch->SetBit(kDoNotProcess, kFALSE);
156 TIter next(branch->GetListOfBranches());
158 // Activate all sub-branches
160 while ((branch_sub=(TBranch*)next())) {
161 count += AliAnalysisDataSlot::EnableBranch(branch_sub->GetName(), tree);
167 //______________________________________________________________________________
168 Bool_t AliAnalysisDataSlot::SetBranchAddress(const char *branchname, void *address)
170 // Set a branch address for input tree. To be called during MyTask::Init()
171 // only if GetBranchAddress() returns a NULL pointer for a tree-type slot.
172 if (GetBranchAddress(branchname)) {
173 Error("SetBranchAddress","Branch address for %s already set by other task. Call first GetBranchAddress() in %s::ConnectInputData()",branchname, fParent->GetName());
176 TTree *tree = (TTree*)GetData();
177 tree->SetBranchAddress(branchname, address);
181 //______________________________________________________________________________
182 TObject *AliAnalysisDataSlot::GetData() const
184 // Retreives the data from the container if it is ready.
186 //AliError(Form("Data slot of type %s of task %s has no connected data container",fType->GetName(), fParent->GetName()));
189 if (!fContainer->IsDataReady()) return NULL;
190 return fContainer->GetData();
193 //______________________________________________________________________________
194 Bool_t AliAnalysisDataSlot::IsDataReady() const
196 // Check if data for this slot is ready in its container.
198 cout<<"Data slot of type "<<GetTitle()<<" of task "<<fParent->GetName()<<" has no connected data container"<<endl;
199 //AliError(Form("Data slot of type %s of task %s has no connected data container",fType->GetName(), fParent->GetName()));
202 return fContainer->IsDataReady();