95c62554fa726e09d3811b12ec9634c53824874f
[u/mrichter/AliRoot.git] / STEER / STEER / AliQADataMaker.cxx
1 /**************************************************************************
2  * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
3  *                                                                        *
4  * Author: The ALICE Off-line Project.                                    *
5  * Contributors are mentioned in the code where appropriate.              *
6  *                                                                        *
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  **************************************************************************/
15
16
17 /* $Id$ */
18
19 //
20 //  Base Class
21 //  Produces the data needed to calculate the quality assurance. 
22 //  All data must be mergeable objects.
23 //  Y. Schutz CERN July 2007
24 //
25
26 // --- ROOT system ---
27 #include <TROOT.h> 
28 #include <TSystem.h> 
29 #include <TFile.h>
30 #include <TList.h> 
31 #include <TTree.h>
32 #include <TClonesArray.h>
33 #include <TParameter.h>
34 #include <TH1K.h>
35 #include <TH2C.h>
36 #include <TH2F.h>
37 #include <TH2F.h>
38 #include <TH2I.h>
39 #include <TH3C.h>
40 #include <TH3F.h>
41 #include <TH3F.h>
42 #include <TH3I.h>
43 #include <TH3S.h>
44 #include <TArrayI.h>
45 #include <TPRegexp.h>
46 // --- Standard library ---
47
48 // --- AliRoot header files ---
49 #include "AliLog.h"
50 #include "AliQADataMaker.h"
51 #include "AliQAChecker.h"
52 #include "AliESDEvent.h"
53 #include "AliRawReader.h"
54 #include "AliDetectorRecoParam.h"
55
56
57 ClassImp(AliQADataMaker)
58
59 const Char_t* AliQADataMaker::fgkTriggerPrefix = "_$TR$_";
60 TObjArray* AliQADataMaker::fgCloningRequest = 0;
61 TObjArray* AliQADataMaker::fgTrigClasses = 0;
62 TObjArray  AliQADataMaker::fgEventTrigClasses;
63
64 //____________________________________________________________________________ 
65 AliQADataMaker::AliQADataMaker(const Char_t * name, const Char_t * title) : 
66   TNamed(name, title), 
67   fOutput(0x0),
68   fDetectorDir(0x0),
69   fDetectorDirName(""), 
70   fCurrentCycle(0), 
71   fCycle(9999999), 
72   fCycleCounter(0), 
73   fWriteExpert(kFALSE),
74   fParameterList(new TList*[AliRecoParam::kNSpecies]), 
75   fRun(0), 
76   fEventSpecie(AliRecoParam::kDefault), 
77   fDigitsArray(NULL) 
78 {
79   // ctor
80   fDetectorDirName = GetName() ; 
81   for (Int_t specie = 0 ; specie < AliRecoParam::kNSpecies ; specie++) {
82     fParameterList[specie] = NULL ; 
83     fEvCountCycle[specie].Set(AliQAv1::kNTASKINDEX);
84     fEvCountTotal[specie].Set(AliQAv1::kNTASKINDEX);
85   }
86   
87 }
88
89 //____________________________________________________________________________ 
90 AliQADataMaker::AliQADataMaker(const AliQADataMaker& qadm) :
91   TNamed(qadm.GetName(), qadm.GetTitle()),
92   fOutput(qadm.fOutput),
93   fDetectorDir(qadm.fDetectorDir),
94   fDetectorDirName(qadm.fDetectorDirName),
95   fCurrentCycle(qadm.fCurrentCycle), 
96   fCycle(qadm.fCycle), 
97   fCycleCounter(qadm.fCycleCounter), 
98   fWriteExpert(qadm.fWriteExpert),
99   fParameterList(qadm.fParameterList),  
100   fRun(qadm.fRun), 
101   fEventSpecie(qadm.fEventSpecie),
102   fDigitsArray(NULL) 
103 {
104   //copy ctor
105   fDetectorDirName = GetName() ; 
106   for (Int_t specie = 0 ; specie < AliRecoParam::kNSpecies ; specie++) {
107     fParameterList[specie] = qadm.fParameterList[specie] ; 
108     fEvCountCycle[specie] = qadm.fEvCountCycle[specie];
109     fEvCountTotal[specie] = qadm.fEvCountTotal[specie];
110     //  fImage[specie] = qadm.fImage[specie] ; 
111   }
112 }
113
114 //____________________________________________________________________________ 
115 AliQADataMaker::~AliQADataMaker()
116 {
117   for (Int_t esIndex = 0 ; esIndex < AliRecoParam::kNSpecies ; esIndex++) {
118     if (fParameterList[esIndex] )
119       delete fParameterList[esIndex] ; 
120   }
121   delete[] fParameterList ; 
122   if (fDigitsArray) {
123     fDigitsArray->Clear() ; 
124     delete fDigitsArray ;
125   }
126 }
127
128 //____________________________________________________________________________
129 Int_t AliQADataMaker::Add2List(TH1 * hist, const Int_t index, TObjArray ** list, const Bool_t expert, const Bool_t image, const Bool_t saveForCorr) 
130
131   // Set histograms memory resident and add to the list
132   // Maximm allowed is 10000
133   
134   Int_t rv = -1 ; 
135   TClass * classType = hist->Class() ;
136   TString className(classType->GetName()) ; 
137   if( ! className.BeginsWith("T") && ! classType->InheritsFrom("TH1") ) {
138     AliError(Form("QA data Object must be a generic ROOT object and derive fom TH1 and not %s", className.Data())) ; 
139   } else if ( index > AliQAv1::GetMaxQAObj() ) {
140     AliError(Form("Max number of authorized QA objects is %d", AliQAv1::GetMaxQAObj())) ; 
141   } else {
142     hist->SetDirectory(0); 
143     if (expert) 
144       hist->SetBit(AliQAv1::GetExpertBit()) ;
145     if (image) 
146       hist->SetBit(AliQAv1::GetImageBit()) ;  
147     const Char_t * name = Form("%s_%s", AliRecoParam::GetEventSpecieName(fEventSpecie), hist->GetName()) ;
148     hist->SetName(name) ; 
149     if(saveForCorr) {  
150       const Char_t * cname = Form("%s_%s", list[AliRecoParam::AConvert(AliRecoParam::kDefault)]->GetName(), hist->GetName()) ;  
151       TParameter<double> * p = new TParameter<double>(cname, 9999.9999) ;
152       if ( fParameterList[AliRecoParam::AConvert(fEventSpecie)] == NULL )
153       {
154         fParameterList[AliRecoParam::AConvert(fEventSpecie)] = new TList() ; 
155         fParameterList[AliRecoParam::AConvert(fEventSpecie)]->SetOwner(kTRUE);
156       }
157       fParameterList[AliRecoParam::AConvert(fEventSpecie)]->Add(p) ;
158     }
159     TObject* old = list[AliRecoParam::AConvert(fEventSpecie)]->At(index);
160     if (old) {
161       AliError(Form("%s - OUPS ! Already got an object (%p,%s) for index=%d => will most probably get a memory leak by replacing it with (%p,%s) !",
162                     GetName(),old,old->GetName(),index,hist,hist->GetName()));
163     }
164     list[AliRecoParam::AConvert(fEventSpecie)]->AddAtAndExpand(hist, index) ; 
165     rv = list[AliRecoParam::AConvert(fEventSpecie)]->GetLast() ;
166   }
167   return rv ; 
168 }
169
170 //____________________________________________________________________________
171 void AliQADataMaker::ClonePerTrigClassL(TObjArray ** list, AliQAv1::TASKINDEX_t task)
172 {
173   // scan the histos of the list, match them to requested histo names to be 
174   // cloned and create the clones per trigger class
175   int spec = AliRecoParam::AConvert(fEventSpecie);
176   if (!fgCloningRequest || !GetNTrigClasses()) return;
177   if (!list || !list[spec]) {
178     AliDebug(1,Form("Array for %s specie is not created",AliRecoParam::GetEventSpecieName(fEventSpecie)));
179     return;
180   }
181   //
182   // if the counters were not expanded, do this now
183   if (fEvCountCycle[spec].GetSize()==AliQAv1::kNTASKINDEX) {
184     fEvCountCycle[spec].Set(AliQAv1::kNTASKINDEX*(GetNTrigClasses()+1)); // +1 for trigger-independent count
185     fEvCountTotal[spec].Set(AliQAv1::kNTASKINDEX*(GetNTrigClasses()+1)); // +1 for trigger-independent count
186   }
187   //
188
189   TString prefix = Form("%s/%s/",GetName(),AliQAv1::GetTaskName(task).Data()); // take care of requests with this prefix
190   int prefLgt = prefix.Length();
191   //
192   for (int ir=fgCloningRequest->GetEntriesFast();ir--;) {
193     TNamed* rec = dynamic_cast<TNamed*>(fgCloningRequest->At(ir));
194     if (!rec) continue;
195     TString hfname = rec->GetName();     // histogram names
196     if (!hfname.BeginsWith(prefix)) continue;
197     Bool_t keepOrig = rec->TestBit(AliQAv1::GetOrigHistoKeptBit()); // is original to be kept?
198     ClonePerTrigClassA(list[spec], hfname.Data()+prefLgt, rec->GetTitle(), keepOrig);
199   }
200   //
201 }
202
203 //____________________________________________________________________________
204 Int_t AliQADataMaker::ClonePerTrigClassA(TObjArray * list, const char* hnm, const char* triggers, Bool_t keepOriginal)
205 {
206   // substitute the matching histogram by the TObjArray containing clones of 
207   // original histogram for each trigger from the space-separated tiggers string
208   // When keepOriginal is requested, the original histo is not deleted and filled for each trigger
209   if (!list) return 0;
210   int nh = list->GetEntriesFast();
211   if (!nh) return 0;
212   //
213   AliDebug(AliQAv1::GetQADebugLevel(),Form("Cloning histogram %s for triggers %s in array %s",hnm,triggers,list->GetName()));
214   //
215   TString trigStr = triggers;
216   TObjArray* trigArr = trigStr.Tokenize(" ");
217   int nTrigs = trigArr->GetEntriesFast();
218   Bool_t cloneAll=kFALSE, cloneMany=kFALSE;
219   if (!nTrigs) {
220     AliError(Form("Triggers string supplied for histo %s is empty", hnm));
221     delete trigArr;
222     return 0;
223   }
224   // match the trigger class id to selected aliases
225   for (int i=nTrigs;i--;) {
226     TObject* alias = fgTrigClasses->FindObject( trigArr->At(i)->GetName() );
227     if (!alias) {
228       AliError(Form("Cloning for undefined trigger class %s was requested for histogram %s",trigArr->At(i)->GetName(),hnm));
229       delete trigArr->RemoveAt(i); 
230       trigArr->Compress();
231       continue;
232     }
233     trigArr->At(i)->SetUniqueID( alias->GetUniqueID() );
234   }
235   //
236   TString histPatt = hnm;
237   if (histPatt == "*") {
238     cloneAll = kTRUE;
239     cloneMany = kTRUE;
240   }
241   else {
242     histPatt.Prepend(Form("%s_", AliRecoParam::GetEventSpecieName(fEventSpecie)));
243     // 
244     // The histogram name may contain %d formats for histos created in loop. 
245     // Then we expect more than 1 histo matching to name
246     TPRegexp rgx("%\\d*d");
247     if (histPatt.Contains(rgx)) { // need to convert to perl expression, make sure there are no perl special characters
248       const char *specials = "^$.{}[]*+?\\";
249       for (int i=strlen(specials);i--;) histPatt.ReplaceAll(specials+i,1,Form("\\%c",specials[i]),2);
250       rgx.Substitute(histPatt,"\\d+","g");
251       histPatt.Prepend('^'); histPatt += "$";
252       cloneMany = kTRUE;
253     }
254   }
255   //
256   int nCloned = 0;
257   for (int ih=0;ih<nh;ih++) {
258     TH1* hist = (TH1*)list->At(ih);
259     if (!hist) continue;
260     if (!cloneAll) {
261       TString hname = hist->GetName();
262       if (cloneMany) {
263         TPRegexp patPR(histPatt);
264         if ( !hname.Contains(patPR) ) continue;
265       }
266       else {
267         if ( !hname.Contains(histPatt) ) continue;
268       }
269     }
270     //
271     // histo name matches, clone it
272     nCloned += ClonePerTrigClassH(ih, list, trigArr, keepOriginal);
273     if (!cloneMany) break; // no wildcards, just one histo is expected
274   }
275   //
276   delete trigArr;
277   return nCloned;
278 }
279
280 //____________________________________________________________________________
281 Int_t AliQADataMaker::ClonePerTrigClassH(Int_t index, TObjArray* list, TObjArray* trigArr, Bool_t keepOriginal)
282 {
283   // substitute the histogram at position index by the TObjArray containing clones of 
284   // original histogram for each trigger from the trigArr
285   // When keepOriginal is requested, the original histo is not deleted and filled for each trigger
286   TH1* hist = (TH1*) list->At(index);
287   if (!hist) return 0; // should never happen, checked in calling method
288
289   if (IsCloningForbidden(hist)) {
290     AliError(Form("Cloning per trigger is forbidden for histo %s at slot %d",hist->GetName(),index));
291     return 0;
292   }
293   //
294   if (hist->TestBit(AliQAv1::GetClonedBit())) {
295     AliError(Form("histo %s at slot %d was already cloned!",((TObjArray*)hist)->GetName(),index));
296     return 0;
297   }
298   //
299   int nTrigs = trigArr->GetEntriesFast();
300   TObjArray* clonesArr = new TObjArray(GetNTrigClasses()+keepOriginal);
301   // transfer the user bits of the histo to be cloned to array
302   for (int ib=14;ib<=23;ib++) if (hist->TestBit(1<<ib)) clonesArr->SetBit(1<<ib);
303   //
304   if (keepOriginal) {
305     clonesArr->AddAt(hist,GetNTrigClasses());
306     clonesArr->SetBit(AliQAv1::GetOrigHistoKeptBit());
307   }
308   clonesArr->SetBit(AliQAv1::GetClonedBit());
309   clonesArr->SetName(hist->GetName());
310   for (int itr=0;itr<nTrigs;itr++) {
311     TObject* trigClass =  trigArr->At(itr);
312     TH1* hclone = (TH1*)hist->Clone(Form("%s%s%s",hist->GetName(), fgkTriggerPrefix, trigClass->GetName()));
313     hclone->SetTitle(Form("%s %s",hist->GetTitle(), trigClass->GetName()));
314     hclone->SetDirectory(hist->GetDirectory());
315     //
316     // NOTE: the clone is added at position corresponding to ID of the trigger alias
317     clonesArr->AddAt(hclone, trigClass->GetUniqueID());
318     hclone->SetBit(AliQAv1::GetClonedBit());
319     AliDebug(AliQAv1::GetQADebugLevel(),Form("Cloned histogram %s for trigger class %s",hist->GetName(),trigClass->GetName()));
320   }
321   //
322   list->RemoveAt(index);    // remove original histogram
323   list->AddAt(clonesArr, index);
324   if (!keepOriginal) delete hist;
325   //
326   clonesArr->SetOwner(kTRUE);
327   return clonesArr->GetEntries();
328 }
329
330 //____________________________________________________________________________
331 Char_t* AliQADataMaker::GetHistoTrigger(const TH1* h)  const
332 {
333   // extract the name of the trigger from the histogram name
334   if (!h || !h->TestBit(AliQAv1::GetClonedBit())) return 0;
335   TString hnm = h->GetName();
336   int idx = hnm.Index(fgkTriggerPrefix);
337   if (idx<0) return 0;  // not cloned
338   return (char*) h->GetName() + idx + sizeof(fgkTriggerPrefix) - 1; 
339 }
340
341 //____________________________________________________________________________
342 Int_t AliQADataMaker::SetEventTrigClasses(const char* triggers)
343 {
344   // sets the array of triggers fired in given event, return the number of triggers
345   //
346   ResetEventTrigClasses();
347   fgEventTrigClasses.SetUniqueID(1); // flag that this is a triggered event
348   if (!GetNTrigClasses()) return 0; // meaningless if the trigger aliases are not set
349   TString trigStr = triggers;
350   TObjArray* tarr = trigStr.Tokenize(" ");
351   int nTrigs = tarr->GetEntriesFast();
352   if (!nTrigs) {
353     AliWarningClass("The string for event triggers is empty");
354     return 0;
355   }
356   int nTrClasses = 0;
357   for (int ial=fgTrigClasses->GetEntriesFast();ial--;) {
358     TNamed *pair = (TNamed*)fgTrigClasses->At(ial);
359     TString triggSet = pair->GetTitle();      // list of trigger names
360     for (int itr=nTrigs;itr--;) {
361       if ( !triggSet.Contains(tarr->At(itr)->GetName()) ) continue;
362       fgEventTrigClasses.Add(pair);
363       nTrClasses++;
364       break; 
365     }
366   }
367   //
368   fgEventTrigClasses.SetOwner(kFALSE);
369   delete tarr;
370   //
371   return nTrClasses;
372 }
373
374 //____________________________________________________________________________
375 TH1* AliQADataMaker::GetMatchingHisto(TObjArray ** list, Int_t index, Int_t trigId)
376 {
377   // get histo with given index matching to trigId-th current trigger class
378   // trigId < 0 means default hist (only if cloning was done) 
379   TObject* data = GetData(list,index);
380   if (!data) return 0;
381   if (trigId<0 || trigId==GetNEventTrigClasses()) { // original histo is requested
382     if (!data->TestBit(AliQAv1::GetClonedBit())) return (TH1*)data; // was not cloned per trigger
383     // check if during the cloning the original histo was kept (always at slot GetNTrigClasses())
384     else if (data->TestBit(AliQAv1::GetOrigHistoKeptBit())) return (TH1*)((TObjArray*)data)->At(GetNTrigClasses());
385     return 0;
386   }
387   // 
388   if (!data->TestBit(AliQAv1::GetClonedBit())) return 0; // no cloning was done
389   if (trigId>GetNEventTrigClasses()) {
390     AliError(Form("Current event has %d triggers only, %d-th is requested",GetNEventTrigClasses(),trigId));
391     return 0; // invalid trigger
392   }
393   int slot = fgEventTrigClasses.At(trigId)->GetUniqueID(); // the histos are at slots corresponding to trig.class ID
394   return (TH1*)((TObjArray*)data)->At(slot);
395   //
396 }
397
398 //____________________________________________________________________________
399 TObjArray* AliQADataMaker::GetMatchingHistosSet(TObjArray ** list, const Int_t* indexList, Int_t nHist, Int_t trigId)
400 {
401   // get set of nHist histos with indices from the indexList matching to trigId-th current trigger
402   // Note: a static array is returned, it will be overwritten at the next call  
403   static TObjArray garr;
404   garr.Clear();
405   for (int ih=0;ih<nHist;ih++) {
406     TH1* histo = GetMatchingHisto(list, indexList[ih],trigId);
407     if (!histo) return 0;    // if at least 1 histo is not found, return nothing
408     garr.Add(histo);
409   }
410   return &garr;
411 }
412
413 //____________________________________________________________________________
414 Bool_t AliQADataMaker::CheckCloningConsistency(TObjArray ** list, const Int_t* indexList, Int_t nHist, Bool_t checkTriggers) 
415 {
416   // Make sure that histograms at slots mentioned in the indexList are either
417   // not cloned per trigger or
418   // cloned for the same amount of triggers and if original histo was kept, then it is done for all histos.
419   // If checkTriggers is requested, apart from clones count also the trigger names are checked 
420   //
421   // This consistency check is needed to ensure validity of the operations over the group of histograms in the EndOfDetectorCycle's
422   //
423   TObjArray* refArr = 0;
424   int refSlot = -1;
425   for (int isl=0;isl<nHist;isl++) {
426     int slot = indexList[isl];
427     TObject* data = GetData(list,slot);
428     if (!data) {AliError(Form("Slot %d is not booked",slot)); return kFALSE;}
429     //
430     if (refSlot<0) { // just take the 1st mentioned slot as a reference;
431       if (data->TestBit(AliQAv1::GetClonedBit())) refArr = (TObjArray*) data; // data was cloned
432       refSlot = slot;
433       continue;
434     }
435     //
436     if (!data->TestBit(AliQAv1::GetClonedBit())) { // this slot is not cloned, compare with reference
437       if (refArr) {AliError(Form("Slot %d is not cloned, slot %d is cloned",slot, refSlot)); return kFALSE;}
438       else continue;
439     }
440     // 
441     TObjArray* currArr = (TObjArray*) data;  // current slot is cloned
442     if (!refArr) {AliError(Form("Slot %d is not cloned, slot %d is cloned",refSlot,slot)); return kFALSE;}
443     // 
444     // both are cloned
445     if (refArr->GetEntriesFast()!=currArr->GetEntriesFast()) {
446       AliError(Form("Different number of clones: slot %d: %d vs slot %d: %d",
447                     refSlot,refArr->GetEntriesFast(), slot,currArr->GetEntriesFast()));
448       return kFALSE;
449     }
450     //
451     if (refArr->TestBit(AliQAv1::GetOrigHistoKeptBit())!=currArr->TestBit(AliQAv1::GetOrigHistoKeptBit())) {
452       AliError(Form("Slot %d kept original histo, slot %d did not",
453                     refArr->TestBit(AliQAv1::GetOrigHistoKeptBit()) ? refSlot:slot,refArr->TestBit(AliQAv1::GetOrigHistoKeptBit()) ? slot:refSlot));
454       return kFALSE;
455     }
456     //
457     if (checkTriggers) {
458       for (int ih=refArr->GetEntriesFast();ih--;) {
459         TH1* hRef = (TH1*)refArr->At(ih);
460         if (!hRef->TestBit(AliQAv1::GetClonedBit())) continue; // original histo was kept, no trigger name is expected
461         TString hnm = ((TH1*)currArr->At(ih))->GetName();
462         if (!hnm.EndsWith( GetHistoTrigger(hRef) )) {
463           AliError(Form("Slots %d and %d have different trigger names for clone %d: %s vs %s",
464                         refSlot,slot,ih,hRef->GetName(),hnm.Data()));
465           return kFALSE;
466         }
467       }
468     }
469   }
470   //
471   return kTRUE;
472 }
473
474 //____________________________________________________________________________
475 TObjArray* AliQADataMaker::GetMatchingHistos(TObjArray ** list, Int_t index, TObjArray* optDest)
476 {
477   // return all histograms of given index matching to any trigger in the current event trigger's list
478   // If the destination optDest is provided - use it, otherwise fill/return own static array
479   // In the latter case one should be careful: the content is overwritten at each call
480   // If the original histo was cloned but kept, it is also returned
481   //
482   // Note: if there are no triggers set, all eventual clones are returned 
483   // (used for EndOfDetectorCycle loop over all histos)
484   static TObjArray garr;
485   TObjArray *dest = optDest ? optDest : &garr;
486   dest->SetOwner(kFALSE);
487   dest->Clear();
488   TObject* data = GetData(list,index);
489   if (!data) return 0;
490   if (!data->TestBit(AliQAv1::GetClonedBit())) dest->AddLast(data); // not cloned per trigger
491   else {
492     TObjArray* arr = dynamic_cast<TObjArray*>(data);
493     if (!arr) return 0;
494     if (IsEventTriggerSet()) {
495       int ncl = GetNEventTrigClasses();
496       for (int icl=0;icl<ncl;icl++) {
497         int indCl = GetEventTrigClass(icl)->GetUniqueID();
498         //      AliInfo(Form("Ind %d at %d of %p of %p",index,indCl, arr, list[AliRecoParam::AConvert(fEventSpecie)]));
499         TH1* histo = dynamic_cast<TH1*>(arr->At(indCl));
500         dest->AddLast(histo);
501         //      AliInfo(Form("EvCl%d IndTr%d add to %d IndH %d %p %s",icl,indCl,dest->LastIndex(),index,histo,histo ? histo->GetName():"XXX"));
502       }
503       // check if original histo was kept
504       if (arr->TestBit(AliQAv1::GetOrigHistoKeptBit())) {
505         TH1* histo = dynamic_cast<TH1*>(arr->At(GetNTrigClasses()));
506         dest->AddLast(histo);
507         //      AliInfo(Form("Def add to %d inex: %d %p %s",dest->LastIndex(),index,histo,histo ? histo->GetName():"XXX"));
508       }
509     }
510     else { // trigger is not set, return all clones
511       for (int ih=arr->GetEntriesFast();ih--;) if (arr->At(ih)) dest->AddLast(arr->At(ih));
512     }
513   }
514   return dest;
515 }
516
517 //____________________________________________________________________________
518 Int_t AliQADataMaker::FillData(TObjArray ** list, Int_t index, double x)
519 {
520   // fills single histo or its trigger-dependent clones, return number of histos filled
521   TObjArray* arr = GetMatchingHistos(list,index);
522   int count = arr->GetEntriesFast();
523   for (int ih=count;ih--;) ((TH1*)arr->At(ih))->Fill(x);
524   return count;
525 }
526
527 //____________________________________________________________________________
528 Int_t AliQADataMaker::FillData(TObjArray ** list, Int_t index, double x, double y)
529 {
530   // fills single histo or its trigger-dependent clones, return number of histos filled
531   TObjArray* arr = GetMatchingHistos(list,index);
532   int count = arr->GetEntriesFast();
533   for (int ih=count;ih--;) ((TH1*)arr->At(ih))->Fill(x,y);
534   return count;
535 }
536
537 //____________________________________________________________________________
538 Int_t AliQADataMaker::FillData(TObjArray ** list, Int_t index, double x, double y, double z)
539 {
540   // fills single histo or its trigger-dependent clones, return number of histos filled
541   TObjArray* arr = GetMatchingHistos(list,index);
542   int count = arr->GetEntriesFast();
543   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->Fill(x,y,z);
544   return count;
545 }
546
547 //____________________________________________________________________________
548 Int_t AliQADataMaker::SetDataBinContent(TObjArray ** list, Int_t index, int bin, double w)
549 {
550   // set bin content of single histo or its trigger-dependent clones, return number of histos filled
551   TObjArray* arr = GetMatchingHistos(list,index);
552   int count = arr->GetEntriesFast();
553   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->SetBinContent(bin,w);
554   return count;
555 }
556
557 //____________________________________________________________________________
558 Int_t AliQADataMaker::SetDataBinContent(TObjArray ** list, Int_t index, int binX, int binY, double w)
559 {
560   // set bin content of single histo or its trigger-dependent clones, return number of histos filled
561   TObjArray* arr = GetMatchingHistos(list,index);
562   int count = arr->GetEntriesFast();
563   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->SetBinContent(binX,binY,w);
564   return count;
565 }
566
567 //____________________________________________________________________________
568 Int_t AliQADataMaker::SetDataBinError(TObjArray ** list, Int_t index, int bin, double err)
569 {
570   // set bin content of single histo or its trigger-dependent clones, return number of histos filled
571   TObjArray* arr = GetMatchingHistos(list,index);
572   int count = arr->GetEntriesFast();
573   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->SetBinError(bin,err);
574   return count;
575 }
576
577 //____________________________________________________________________________
578 Int_t AliQADataMaker::SetDataBinError(TObjArray ** list, Int_t index, int binX, int binY, double err)
579 {
580   // set bin content of single histo or its trigger-dependent clones, return number of histos filled
581   TObjArray* arr = GetMatchingHistos(list,index);
582   int count = arr->GetEntriesFast();
583   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->SetBinError(binX,binY,err);
584   return count;
585 }
586
587 //____________________________________________________________________________
588 Int_t AliQADataMaker::ResetData(TObjArray ** list, Int_t index, Option_t* option)
589 {
590   // reset content of single histo or its trigger-dependent clones, return number of histos processed
591   TObjArray* arr = GetMatchingHistos(list,index);
592   int count = arr->GetEntriesFast();
593   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->Reset(option);
594   return count;
595 }
596
597 //____________________________________________________________________________
598 Int_t AliQADataMaker::ResetStatsData(TObjArray ** list, Int_t index)
599 {
600   // reset stats of single histo or its trigger-dependent clones, return number of histos processed
601   TObjArray* arr = GetMatchingHistos(list,index);
602   int count = arr->GetEntriesFast();
603   for (int ih=count;ih--;) ((TH2*)arr->At(ih))->ResetStats();
604   return count;
605 }
606
607 //____________________________________________________________________________
608 TH1 *  AliQADataMaker::CloneMe(TH1 * hist, Int_t specie) const  
609 {
610   // clones a histogram 
611   const Char_t * name = Form("%s_%s", AliRecoParam::GetEventSpecieName(specie), hist->GetName()) ;
612   TH1 * hClone = static_cast<TH1 *>(hist->Clone(name)) ; 
613   if ( hist->TestBit(AliQAv1::GetExpertBit()) )
614     hClone->SetBit(AliQAv1::GetExpertBit()) ; 
615   if ( hist->TestBit(AliQAv1::GetImageBit()) )
616     hClone->SetBit(AliQAv1::GetImageBit()) ; 
617   return hClone ; 
618 }
619
620 //____________________________________________________________________________
621 void AliQADataMaker::DefaultEndOfDetectorCycle(AliQAv1::TASKINDEX_t task) 
622 {
623   // this method must be oveloaded by detectors
624   // sets the QA result to Fatal
625   AliQAv1::Instance(AliQAv1::GetDetIndex(GetName())) ;
626   AliQAv1 * qa = AliQAv1::Instance(task) ;
627   for (Int_t specie = 0 ; specie < AliRecoParam::kNSpecies ; specie++) 
628     qa->Set(AliQAv1::kFATAL, specie) ; 
629   AliQAv1::GetQAResultFile()->cd() ; 
630   qa->Write(AliQAv1::GetQAName(), kWriteDelete) ;   
631   AliQAv1::GetQAResultFile()->Close() ; 
632 }
633
634 //____________________________________________________________________________ 
635 void AliQADataMaker::Finish() const 
636
637   // write to the output File
638   if (fOutput) 
639     fOutput->Close() ; 
640
641
642 //____________________________________________________________________________ 
643 TH1* AliQADataMaker::GetData(TObjArray ** list, const Int_t index, int cloneID)  
644
645   // get the cloneID-th clone of the histo, -1 for original (if kept)
646   TObject* data = GetData(list,index);
647   if (!data) return 0;
648   Bool_t orig = cloneID<0 || cloneID==GetNTrigClasses();
649   if (data->TestBit(AliQAv1::GetClonedBit())) {
650     if (orig) return data->TestBit(AliQAv1::GetOrigHistoKeptBit()) ? (TH1*)((TObjArray*)data)->At(GetNTrigClasses()) : 0;
651     else      return (TH1*)((TObjArray*)data)->At(cloneID); // there was a cloning
652   }
653   //
654   // not cloned, is the original histo requested?
655   if (cloneID<0 || cloneID==GetNTrigClasses()) return (TH1*)data;
656   return 0;
657   //
658 }
659
660 //____________________________________________________________________________ 
661 TObjArray* AliQADataMaker::GetDataOfTrigClass(TObjArray ** list, Int_t specieIndex, int cloneID, TObjArray *dest)  
662
663   // get all histos for cloneID-th trigger class (-1 is for original "all-triggers" histos) in 
664   // a single array (if dest is not provided, use its own static array). 
665   // Existing histos are attached at their original positions
666   TObjArray* arr = list[specieIndex] ;
667   return GetDataOfTrigClass(arr, cloneID, dest);
668 }
669
670 //____________________________________________________________________________ 
671 TObjArray* AliQADataMaker::GetDataOfTrigClass(TObjArray *arr, int cloneID, TObjArray *dest)  
672
673   // get all histos for cloneID-th trigger class (-1 is for original "all-triggers" histos) in 
674   // a single array (if dest is not provided, use its own static array). 
675   // Existing histos are attached at their original positions
676   static TObjArray arrTransf;
677   TObjArray* destS = dest ? dest : &arrTransf;
678   destS->SetOwner(kFALSE);
679   destS->Clear();
680   if (arr) {
681     Bool_t orig = cloneID<0 || cloneID==GetNTrigClasses(); // is trigger-blind histo requested?
682     int nh = arr->GetEntriesFast();
683     if (nh>destS->GetSize()) destS->Expand(nh);
684     for (int ih=nh;ih--;) {
685       TObject* ob = arr->At(ih);
686       if (!ob) continue;
687       //
688       if (ob->TestBit(AliQAv1::GetClonedBit())) { // this is array of cloned histos
689         if (orig) ob = ob->TestBit(AliQAv1::GetOrigHistoKeptBit()) ? ((TObjArray*)ob)->At(GetNTrigClasses()) : 0;
690         else      ob = ((TObjArray*)ob)->At(cloneID);
691       }
692       else if (!orig) ob = 0;   // histogram was not cloned but the clone is requested
693       if (!ob) continue;
694       (*destS)[ih] = ob;
695     }
696   } 
697   return destS;
698   //
699 }
700
701 //____________________________________________________________________________ 
702 TObjArray* AliQADataMaker::GetDataOfTrigClass(TObjArray ** list, int cloneID, TObjArray *dest)  
703
704   // get all histos for cloneID-th trigger class (-1 is for original "all-triggers" histos) in 
705   // a single array (if dest is not provided, use its own static array). 
706   // Existing histos are attached at their original positions
707   //
708   GetData(list,0);  //just to initialize, if needed
709   Int_t esindex = AliRecoParam::AConvert(fEventSpecie);
710   return GetDataOfTrigClass(list, esindex, cloneID, dest);
711   //
712 }
713
714 //____________________________________________________________________________ 
715 TObject * AliQADataMaker::GetData(TObjArray ** list, const Int_t index)  
716
717   // Returns the QA object at index. Limit is AliQAv1::GetMaxQAObj() 
718   if ( ! list ) {
719     AliError("Data list is NULL !!") ; 
720     return NULL ;               
721   }
722   Int_t esindex = AliRecoParam::AConvert(fEventSpecie) ; 
723   TObject* histClone = NULL ; 
724   TObjArray * arr = list[esindex] ; 
725   if (arr) {
726     if ( ! arr->GetEntriesFast() ) {
727       // Initializes the histograms 
728       TString arrName(arr->GetName()) ; 
729       if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kRAWS)))
730         InitRaws() ; 
731       else if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kHITS)))
732         InitHits() ; 
733       else if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kSDIGITS)))
734         InitSDigits() ; 
735       else if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kDIGITS)))
736         InitDigits() ; 
737       else if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kDIGITSR)))
738         InitDigits() ; 
739       else if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kRECPOINTS)))
740         InitRecPoints() ; 
741       else if (arrName.Contains(AliQAv1::GetTaskName(AliQAv1::kESDS)))
742         InitESDs() ; 
743     }
744     if ( index > AliQAv1::GetMaxQAObj() ) {
745       AliError(Form("Max number of authorized QA objects is %d", AliQAv1::GetMaxQAObj())) ; 
746     } else {
747       if ( arr->At(index) )  {
748         histClone = arr->At(index); 
749       }         
750     }
751   }
752   return histClone ;            
753 }
754
755 //____________________________________________________________________________ 
756 TObjArray*  AliQADataMaker::Init(AliQAv1::TASKINDEX_t task, AliRecoParam::EventSpecie_t es, Int_t cycles)
757 {
758   // Initialializes and  returns the QAData list for a given event specie
759   TObjArray ** ar = Init(task, cycles) ; 
760   return ar[AliRecoParam::AConvert(es)] ;  
761 }
762
763 //____________________________________________________________________________ 
764 Bool_t AliQADataMaker::IsValidEventSpecie(Int_t eventSpecieIndex, TObjArray ** list)
765 {
766   // check if event specie was present in current run or 
767   // if histograms of this event specie have been created
768   if (! AliQAv1::Instance(AliQAv1::GetDetIndex(GetName()))->IsEventSpecieSet(AliRecoParam::ConvertIndex(eventSpecieIndex)) || ! list[eventSpecieIndex]->GetEntriesFast() )
769     return kFALSE ;
770   else
771     return kTRUE ;
772 }
773
774 //____________________________________________________________________________ 
775 void AliQADataMaker::SetCloningRequest(TObjArray* aliases, TObjArray* histos)
776 {
777   // set associations {trigger names} <-> {trigger class alias}
778   //
779   const UInt_t kDummyID = 0xffff;
780   //
781   if (fgTrigClasses || fgCloningRequest) {
782     AliWarningClass("Cloning request is already set");
783     return;
784   }
785   ResetEventTrigClasses(); 
786   if (!aliases || !histos) {
787     AliWarningClass("Cloning request is incomplete");
788     return;
789   }
790   fgTrigClasses = aliases;
791   fgCloningRequest = histos;
792   //
793   // flag those aliases which are actually used
794   fgCloningRequest->Compress();
795   fgTrigClasses->Compress();
796   int nalias = fgTrigClasses->GetEntriesFast();
797   int nhisto = fgCloningRequest->GetEntriesFast();
798   //
799   int naliasUsed = 0;
800   for (int ial=0;ial<nalias;ial++) {
801     TNamed* alias = (TNamed*)fgTrigClasses->At(ial);
802     alias->SetUniqueID(kDummyID);
803     TString aliasName = alias->GetName();
804     for (int ih=nhisto;ih--;) {
805       TNamed* histo = (TNamed*)fgCloningRequest->At(ih);
806       TString histoReq = histo->GetTitle();    // list of aliases for which the histo must be cloned
807       TObjArray* alList = histoReq.Tokenize(" ");
808       if (!alList) continue;
809       for (int iha=alList->GetEntriesFast();iha--;) {
810         if (!(aliasName == alList->At(iha)->GetName())) continue;
811         alias->SetUniqueID(naliasUsed++);      // acknowledge used alias
812         break;
813       }
814       if (alias->GetUniqueID()!=kDummyID) break;  // once alias is validated, check the next one
815     }
816   }
817   // eliminate unused aliases
818   for (int ial=0;ial<nalias;ial++) if (fgTrigClasses->At(ial)->GetUniqueID()==kDummyID) delete fgTrigClasses->RemoveAt(ial);
819   fgTrigClasses->Compress();
820   //
821   AliInfoClass("Aliases for trigger classes:");
822   for (int i=0;i<fgTrigClasses->GetEntriesFast();i++) {
823     TNamed* item = (TNamed*)fgTrigClasses->At(i);
824     AliInfoClass(Form("%s -> %s",item->GetName(),item->GetTitle()));
825   }
826   //
827   AliInfoClass("Histograms to clone:");
828   for (int i=0;i<fgCloningRequest->GetEntriesFast();i++) {
829     TNamed* item = (TNamed*)fgCloningRequest->At(i);
830     AliInfoClass(Form("%s -> %s %s",item->GetName(),item->GetTitle(),
831                       item->TestBit(AliQAv1::GetOrigHistoKeptBit()) ? " + TriggerBlind":""));
832   }
833   // 
834 }
835
836 //____________________________________________________________________________ 
837 void AliQADataMaker::IncEvCountCycle(AliQAv1::TASKINDEX_t task, Int_t diff)
838 {
839   // incerment by "diff" the cycle counters for the current event trigger classes (+ the global one)
840   int ncl = GetNTrigClasses();
841   int isp = AliRecoParam::AConvert(fEventSpecie);
842   //
843   if (fEvCountCycle[isp].GetSize()==AliQAv1::kNTASKINDEX && ncl>0) fEvCountCycle[isp].Set(AliQAv1::kNTASKINDEX*(GetNTrigClasses()+1)); // +1 for trigger-independent count
844   //
845   fEvCountCycle[isp][task*(1+ncl)+ncl] += diff; // trigger independent counter
846   for (int icl=GetNEventTrigClasses();icl--;) fEvCountCycle[isp][task*(1+ncl)+ GetEventTrigClass(icl)->GetUniqueID()] += diff;
847 }
848
849 //____________________________________________________________________________ 
850 void AliQADataMaker::IncEvCountTotal(AliQAv1::TASKINDEX_t task, Int_t diff)
851 {
852   // incerment by "diff" the cycle counters for the current event trigger classes (+ the global one)
853   int ncl = GetNTrigClasses();
854   int isp = AliRecoParam::AConvert(fEventSpecie);
855   //
856   if (fEvCountTotal[isp].GetSize()==AliQAv1::kNTASKINDEX && ncl>0) fEvCountTotal[isp].Set(AliQAv1::kNTASKINDEX*(GetNTrigClasses()+1)); // +1 for trigger-independent count
857   //
858   fEvCountTotal[isp][task*(1+ncl)+ncl] += diff; // trigger independent counter
859   for (int icl=GetNEventTrigClasses();icl--;) fEvCountTotal[isp][task*(1+ncl)+ GetEventTrigClass(icl)->GetUniqueID()] += diff;
860 }
861
862 //____________________________________________________________________________
863 void AliQADataMaker::ResetEvCountCycle(AliRecoParam::EventSpecie_t isp, AliQAv1::TASKINDEX_t task) 
864 {
865   // reset counter for specific trigger class for specific specie (within the cycle)
866   int ncl = GetNTrigClasses();
867   // check if it was already expanded
868   if (fEvCountCycle[isp].GetSize()==AliQAv1::kNTASKINDEX) fEvCountCycle[isp].Set(AliQAv1::kNTASKINDEX*(ncl+1));
869   for (int icl=ncl+1;icl--;) fEvCountCycle[AliRecoParam::AConvert(isp)][task*(1+ncl) + icl] = 0;
870 }
871
872 //____________________________________________________________________________
873 void AliQADataMaker::ResetEvCountTotal(AliRecoParam::EventSpecie_t isp, AliQAv1::TASKINDEX_t task) 
874 {
875   // reset counter for specific trigger class for specific specie (global count)
876   int ncl = GetNTrigClasses();
877   // check if it was already expanded
878   if (fEvCountTotal[isp].GetSize()==AliQAv1::kNTASKINDEX) fEvCountTotal[isp].Set(AliQAv1::kNTASKINDEX*(ncl+1));
879   for (int icl=ncl+1;icl--;) fEvCountTotal[AliRecoParam::AConvert(isp)][task*(1+ncl) + icl] = 0;
880 }
881
882 //____________________________________________________________________________
883 Int_t AliQADataMaker::GetEvCountCycle(AliRecoParam::EventSpecie_t isp, AliQAv1::TASKINDEX_t task, Int_t trCl) const
884 {
885   // get counter for specific trigger class for specific specie (within the cycle)
886   int ncl = GetNTrigClasses();
887   return fEvCountCycle[AliRecoParam::AConvert(isp)][task*(1+ncl) + (trCl<0||trCl>=ncl ? ncl:trCl)];
888 }
889 //____________________________________________________________________________
890 Int_t AliQADataMaker::GetEvCountTotal(AliRecoParam::EventSpecie_t isp, AliQAv1::TASKINDEX_t task, Int_t trCl) const
891 {
892   // get counter for specific trigger class for specific specie (global count)
893   int ncl = GetNTrigClasses();
894   return fEvCountTotal[AliRecoParam::AConvert(isp)][task*(1+ncl) + (trCl<0||trCl>=ncl ? ncl:trCl)];
895 }
896