]> git.uio.no Git - u/mrichter/AliRoot.git/blame - STEER/AliQAChecker.cxx
Updating doc
[u/mrichter/AliRoot.git] / STEER / AliQAChecker.cxx
CommitLineData
421ab0fb 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/* $Id: */
17
18///////////////////////////////////////////////////////////////////////////////
19// //
20// class for running the Quality Assurance Checker
21// //
22///////////////////////////////////////////////////////////////////////////////
23
4edbc5bc 24#include "AliCDBEntry.h"
25#include "AliCDBManager.h"
96d67a8d 26#include "AliCDBStorage.h"
cbae8032 27#include "AliEventInfo.h"
421ab0fb 28#include "AliLog.h"
29#include "AliModule.h"
2e42b4d4 30#include "AliQA.h"
31#include "AliQAChecker.h"
32#include "AliQACheckerBase.h"
421ab0fb 33
a5fa6165 34#include <TKey.h>
421ab0fb 35#include <TObjArray.h>
cbae8032 36#include <TObjString.h>
a5fa6165 37#include <TPluginManager.h>
38#include <TROOT.h>
421ab0fb 39#include <TStopwatch.h>
40#include <TString.h>
a5fa6165 41#include <TSystem.h>
a4976ef3 42#include <TList.h>
421ab0fb 43
2e42b4d4 44ClassImp(AliQAChecker)
45 AliQAChecker * AliQAChecker::fgQAChecker = 0x0 ;
421ab0fb 46
47//_____________________________________________________________________________
2e42b4d4 48AliQAChecker::AliQAChecker(const char* name, const char* title) :
421ab0fb 49 TNamed(name, title),
a5fa6165 50 fDataFile(0x0),
cbae8032 51 fEventInfo(0x0),
52 fEventInfoOwner(kFALSE),
4edbc5bc 53 fRefFile(0x0),
a5fa6165 54 fFoundDetectors(".")
421ab0fb 55{
a5fa6165 56 // ctor: initialise checkers and open the data file
2e42b4d4 57 for (Int_t det = 0 ; det < AliQA::kNDET ; det++)
a5fa6165 58 fCheckers[det] = NULL ;
421ab0fb 59}
60
61//_____________________________________________________________________________
2e42b4d4 62AliQAChecker::AliQAChecker(const AliQAChecker& qac) :
421ab0fb 63 TNamed(qac),
a5fa6165 64 fDataFile(qac.fDataFile),
cbae8032 65 fEventInfo(qac.fEventInfo),
66 fEventInfoOwner(kFALSE),
4edbc5bc 67 fRefFile(qac.fRefFile),
a5fa6165 68 fFoundDetectors(qac.fFoundDetectors)
421ab0fb 69{
a5fa6165 70 // copy constructor
71
2e42b4d4 72 for (Int_t det = 0 ; det < AliQA::kNDET ; det++)
a5fa6165 73 fCheckers[det] = NULL ;
421ab0fb 74}
75
76//_____________________________________________________________________________
2e42b4d4 77AliQAChecker& AliQAChecker::operator = (const AliQAChecker& qac)
421ab0fb 78{
79// assignment operator
80
2e42b4d4 81 this->~AliQAChecker();
82 new(this) AliQAChecker(qac);
421ab0fb 83 return *this;
84}
85
86//_____________________________________________________________________________
2e42b4d4 87AliQAChecker::~AliQAChecker()
421ab0fb 88{
89// clean up
cbae8032 90 if (fEventInfo)
91 delete fEventInfo ;
a4976ef3 92 delete [] fCheckers ;
8bea2de0 93 AliQA::Close() ;
421ab0fb 94}
95
96//_____________________________________________________________________________
2e42b4d4 97 AliQACheckerBase * AliQAChecker::GetDetQAChecker(Int_t det)
421ab0fb 98{
a5fa6165 99 // Gets the Quality Assurance checker for the detector specified by its name
100
101 if (fCheckers[det])
102 return fCheckers[det];
103
2e42b4d4 104 TString detName(AliQA::GetDetName(det)) ;
a5fa6165 105
54a7f3ac 106 AliDebug(1, Form("Retrieving QA checker for %s", detName.Data())) ;
a5fa6165 107 TPluginManager* pluginManager = gROOT->GetPluginManager() ;
2e42b4d4 108 TString qacName = "Ali" + detName + "QAChecker" ;
a5fa6165 109
2e42b4d4 110 AliQACheckerBase * qac = NULL ;
a5fa6165 111 // first check if a plugin is defined for the quality assurance checker
2e42b4d4 112 TPluginHandler* pluginHandler = pluginManager->FindHandler("AliQAChecker", detName.Data());
a5fa6165 113 // if not, add a plugin for it
114 if (!pluginHandler) {
115 //AliInfo(Form("defining plugin for %s", qacName.Data()));
116 TString libs = gSystem->GetLibraries();
117
118 if (libs.Contains("lib" + detName + "base.so") || (gSystem->Load("lib" + detName + "base.so") >= 0))
2e42b4d4 119 pluginManager->AddHandler("AliQAChecker", detName, qacName, detName + "qac", qacName + "()");
a5fa6165 120 else
2e42b4d4 121 pluginManager->AddHandler("AliQAChecker", detName, qacName, detName, qacName + "()");
a5fa6165 122
2e42b4d4 123 pluginHandler = pluginManager->FindHandler("AliQAChecker", detName);
a5fa6165 124
125 if (pluginHandler && (pluginHandler->LoadPlugin() == 0))
2e42b4d4 126 qac = (AliQACheckerBase *) pluginHandler->ExecPlugin(0);
a5fa6165 127
128 if (qac)
129 fCheckers[det] = qac ;
421ab0fb 130 }
a5fa6165 131
132 return qac ;
133}
cbae8032 134
a5fa6165 135//_____________________________________________________________________________
f73f556a 136void AliQAChecker::GetRefSubDir(const char * det, const char * task, TDirectory *& dirFile, TObjArray *& dirOCDB)
a5fa6165 137{
138 // Opens and returns the file with the reference data
4edbc5bc 139
cbae8032 140 dirFile = NULL ;
141 dirOCDB = NULL ;
142 TString refStorage(AliQA::GetQARefStorage()) ;
143 //refStorage += AliQA::GetQARefFileName() ;
144 if (refStorage.Contains(AliQA::GetLabLocalFile())) {
145 refStorage.ReplaceAll(AliQA::GetLabLocalFile(), "") ;
146 if ( fRefFile )
147 if ( fRefFile->IsOpen() )
148 fRefFile->Close() ;
149 fRefFile = TFile::Open(refStorage.Data()) ;
150 if (!fRefFile) {
151 AliError(Form("Cannot find reference file %s", refStorage.Data())) ;
152 dirFile = NULL ;
153 }
154 dirFile = fRefFile->GetDirectory(det) ;
155 if (!dirFile) {
156 AliWarning(Form("Directory %s not found in %d", det, refStorage.Data())) ;
157 } else {
158 dirFile = dirFile->GetDirectory(task) ;
159 if (!dirFile)
160 AliWarning(Form("Directory %s/%s not found in %s", det, task, refStorage.Data())) ;
161 }
162 } else if (refStorage.Contains(AliQA::GetLabLocalOCDB()) || refStorage.Contains(AliQA::GetLabAliEnOCDB())) {
163 AliCDBManager* man = AliCDBManager::Instance() ;
164 if ( strcmp(AliQA::GetRefDataDirName(), "") == 0 ) { // the name of the last level of the directory is not set (RUNTYPE)
165 // Get it from EventInfo
166 if (!fEventInfo) // not yet set, get the info from GRP
167 LoadEventInfoFromGRP() ;
168
169 AliQA::SetQARefDataDirName(fEventInfo->GetRunType()) ;
170 }
171 if ( ! man->GetLock() ) {
172 man->SetDefaultStorage(AliQA::GetQARefStorage()) ;
173 man->SetSpecificStorage("*", AliQA::GetQARefStorage()) ;
174 }
175 char * detOCDBDir = Form("%s/%s/%s", det, AliQA::GetRefOCDBDirName(), AliQA::GetRefDataDirName()) ;
176 AliInfo(Form("Reference QA data are taken from %s", detOCDBDir)) ;
177 AliCDBEntry * entry = man->Get(detOCDBDir, man->GetRun()) ;
178 if (entry) {
179 TList * listDetQAD = dynamic_cast<TList *>(entry->GetObject()) ;
180 if ( listDetQAD )
181 dirOCDB = dynamic_cast<TObjArray *>(listDetQAD->FindObject(task)) ;
182 }
183 }
421ab0fb 184}
185
a4976ef3 186//_____________________________________________________________________________
2e42b4d4 187AliQAChecker * AliQAChecker::Instance()
a4976ef3 188{
189 // returns unique instance of the checker
190 if ( ! fgQAChecker )
2e42b4d4 191 fgQAChecker = new AliQAChecker() ;
a4976ef3 192 return fgQAChecker ;
193}
194
cbae8032 195//_____________________________________________________________________________
196void AliQAChecker::LoadEventInfoFromGRP()
197{
198 AliCDBManager* man = AliCDBManager::Instance() ;
199 AliCDBEntry* entry = man->Get(AliQA::GetGRPPath().Data());
200 TMap * data = 0x0 ;
201 if (entry)
202 data = dynamic_cast<TMap*>(entry->GetObject());
203 if (!data) {
204 AliFatal("No GRP entry found in OCDB!");
205 }
206 TObjString *lhcState=
207 dynamic_cast<TObjString*>(data->GetValue("fLHCState"));
208 if (!lhcState) {
209 AliWarning(Form("%s entry: missing value for the LHC state ! Using UNKNOWN", AliQA::GetGRPPath().Data()));
210 }
211 TObjString *beamType=
212 dynamic_cast<TObjString*>(data->GetValue("fAliceBeamType"));
213 if (!beamType) {
214 AliWarning(Form("%s entry: missing value for the LHC state ! Using UNKNOWN", AliQA::GetGRPPath().Data()));
215 }
216 TObjString *runType=
217 dynamic_cast<TObjString*>(data->GetValue("fRunType"));
218 if (!runType) {
219 AliWarning(Form("%s entry: missing value for the run type ! Using UNKNOWN", AliQA::GetGRPPath().Data())); }
220 TObjString *activeDetectors=
221 dynamic_cast<TObjString*>(data->GetValue("fDetectorMask"));
222 if (!activeDetectors) {
223 AliWarning(Form("%s entry: missing value for the detector mask ! Using ALL", AliQA::GetGRPPath().Data()));
224 }
225 fEventInfo = new AliEventInfo(lhcState ? lhcState->GetString().Data() : "UNKNOWN",
226 beamType ? beamType->GetString().Data() : "UNKNOWN",
227 runType ? runType->GetString().Data() : "UNKNOWN",
228 activeDetectors ? activeDetectors->GetString().Data() : "ALL");
229 fEventInfoOwner = kTRUE ;
230}
231
421ab0fb 232//_____________________________________________________________________________
808b7099 233Bool_t AliQAChecker::Run(const char * fileName)
421ab0fb 234{
a5fa6165 235 // run the Quality Assurance Checker for all tasks Hits, SDigits, Digits, recpoints, tracksegments, recparticles and ESDs
a4976ef3 236 // starting from data in file
421ab0fb 237
238 Bool_t rv = kFALSE ;
a5fa6165 239
421ab0fb 240 TStopwatch stopwatch;
241 stopwatch.Start();
242
a5fa6165 243 //search for all detectors QA directories
8bea2de0 244 TList * detKeyList = AliQA::GetQADataFile(fileName)->GetListOfKeys() ;
a5fa6165 245 TIter nextd(detKeyList) ;
246 TKey * detKey ;
247 while ( (detKey = dynamic_cast<TKey *>(nextd()) ) ) {
54a7f3ac 248 AliDebug(1, Form("Found %s", detKey->GetName())) ;
a5fa6165 249 //Check which detector
250 TString detName ;
251 TString detNameQA(detKey->GetName()) ;
252 Int_t det ;
2e42b4d4 253 for ( det = 0; det < AliQA::kNDET ; det++) {
254 detName = AliQA::GetDetName(det) ;
a5fa6165 255 if (detNameQA.Contains(detName)) {
256 fFoundDetectors+=detName ;
257 fFoundDetectors+="." ;
258 break ;
259 }
260 }
8bea2de0 261 TDirectory * detDir = AliQA::GetQADataFile(fileName)->GetDirectory(detKey->GetName()) ;
a5fa6165 262 TList * taskKeyList = detDir->GetListOfKeys() ;
263 TIter nextt(taskKeyList) ;
264 TKey * taskKey ;
265 // now search for the tasks dir
266 while ( (taskKey = static_cast<TKey *>(nextt()) ) ) {
267 TString taskName( taskKey->GetName() ) ;
268 AliInfo(Form("Found %s", taskName.Data())) ;
269 TDirectory * taskDir = detDir->GetDirectory(taskName.Data()) ;
270 taskDir->cd() ;
2e42b4d4 271 AliQACheckerBase * qac = GetDetQAChecker(det) ;
a5fa6165 272 if (qac)
a4976ef3 273 AliInfo(Form("QA checker found for %s", detName.Data())) ;
a5fa6165 274 if (!qac)
a4976ef3 275 AliFatal(Form("QA checker not found for %s", detName.Data())) ;
96d67a8d 276 AliQA::ALITASK_t index = AliQA::kNULLTASK ;
2e42b4d4 277 if ( taskName == AliQA::GetTaskName(AliQA::kHITS) )
278 index = AliQA::kSIM ;
279 if ( taskName == AliQA::GetTaskName(AliQA::kSDIGITS) )
280 index = AliQA::kSIM ;
281 if ( taskName == AliQA::GetTaskName(AliQA::kDIGITS) )
282 index = AliQA::kSIM ;
283 if ( taskName == AliQA::GetTaskName(AliQA::kRECPOINTS) )
284 index = AliQA::kREC ;
285 if ( taskName == AliQA::GetTaskName(AliQA::kTRACKSEGMENTS) )
286 index = AliQA::kREC ;
287 if ( taskName == AliQA::GetTaskName(AliQA::kRECPARTICLES) )
288 index = AliQA::kREC ;
289 if ( taskName == AliQA::GetTaskName(AliQA::kESDS) )
290 index = AliQA::kESD ;
96d67a8d 291 qac->Init(AliQA::DETECTORINDEX_t(det)) ;
10a28129 292
f73f556a 293 TDirectory * refDir = NULL ;
294 TObjArray * refOCDBDir = NULL ;
4edbc5bc 295 GetRefSubDir(detNameQA.Data(), taskName.Data(), refDir, refOCDBDir) ;
296 if ( refDir || refOCDBDir) {
297 qac->SetRefandData(refDir, refOCDBDir, taskDir) ;
298 qac->Run(index) ;
ac2bb64a 299 }
4edbc5bc 300 }
301 }
a5fa6165 302 AliInfo("QA performed for following detectors:") ;
2e42b4d4 303 for ( Int_t det = 0; det < AliQA::kNDET; det++) {
304 if (fFoundDetectors.Contains(AliQA::GetDetName(det))) {
305 printf("%s, ",AliQA::GetDetName(det)) ;
306 fFoundDetectors.ReplaceAll(AliQA::GetDetName(det), "") ;
a5fa6165 307 }
421ab0fb 308 }
a5fa6165 309 printf("\n") ;
310 rv = kTRUE ;
421ab0fb 311
a5fa6165 312 return rv ;
313
421ab0fb 314}
315
a4976ef3 316//_____________________________________________________________________________
96d67a8d 317Bool_t AliQAChecker::Run(AliQA::DETECTORINDEX_t det, AliQA::TASKINDEX_t task, TObjArray * list)
a4976ef3 318{
d6372ce8 319 // run the Quality Assurance Checker for detector det, for task task starting from data in list
a4976ef3 320
d6372ce8 321 AliQACheckerBase * qac = GetDetQAChecker(det) ;
322 if (qac)
323 AliDebug(1, Form("QA checker found for %s", AliQA::GetDetName(det).Data())) ;
324 if (!qac)
325 AliError(Form("QA checker not found for %s", AliQA::GetDetName(det).Data())) ;
a4976ef3 326
d6372ce8 327 AliQA::ALITASK_t index = AliQA::kNULLTASK ;
328 if ( task == AliQA::kRAWS )
2e42b4d4 329 index = AliQA::kRAW ;
d6372ce8 330 else if ( task == AliQA::kHITS )
2e42b4d4 331 index = AliQA::kSIM ;
d6372ce8 332 else if ( task == AliQA::kSDIGITS )
2e42b4d4 333 index = AliQA::kSIM ;
d6372ce8 334 else if ( task == AliQA::kDIGITS )
2e42b4d4 335 index = AliQA::kSIM ;
d6372ce8 336 else if ( task == AliQA::kRECPOINTS )
2e42b4d4 337 index = AliQA::kREC ;
d6372ce8 338 else if ( task == AliQA::kTRACKSEGMENTS )
2e42b4d4 339 index = AliQA::kREC ;
d6372ce8 340 else if ( task == AliQA::kRECPARTICLES )
2e42b4d4 341 index = AliQA::kREC ;
d6372ce8 342 else if ( task == AliQA::kESDS )
2e42b4d4 343 index = AliQA::kESD ;
4edbc5bc 344
d6372ce8 345 TDirectory * refDir = NULL ;
346 TObjArray * refOCDBDir = NULL ;
347 qac->Init(det) ;
4edbc5bc 348 GetRefSubDir(AliQA::GetDetName(det), AliQA::GetTaskName(task), refDir, refOCDBDir) ;
d6372ce8 349 if ( refDir || refOCDBDir) // references found
4edbc5bc 350 qac->SetRefandData(refDir, refOCDBDir) ;
d6372ce8 351 qac->Run(index, list) ;
352 return kTRUE ;
a4976ef3 353}
354
421ab0fb 355
356