[u/mrichter/AliRoot.git] / STEER / AliQA.h

#ifndef ALIQA_H
#define ALIQA_H
/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 * See cxx source for full Copyright notice                               */

/* $Id$ */

//
// Quality Assurance Object
//

#include <TNamed.h> 
#include <TMath.h> 
class TFile ; 

#include "AliLog.h"
#include "AliRecoParam.h"

class AliQA : public TNamed {
public:
  
  enum DETECTORINDEX_t {
    kNULLDET=-1, kITS, kTPC, kTRD, kTOF, kPHOS, kHMPID, kEMCAL, kMUON, kFMD,
    kZDC, kPMD, kT0, kVZERO, kACORDE, kHLT, kGLOBAL, kCORR, kNDET};
  enum ALITASK_t {
    kNULLTASK=-1, kRAW, kSIM, kREC, kESD, kANA, kNTASK };
  enum QABIT_t {
    kNULLBit=-1, kINFO, kWARNING, kERROR, kFATAL, kNBIT };
  enum TASKINDEX_t {
    kNULLTASKINDEX=-1, kRAWS, kHITS, kSDIGITS, kDIGITS, kRECPOINTS, kTRACKSEGMENTS, kRECPARTICLES, kESDS, kNTASKINDEX };
  
  // Creators - destructors
  AliQA(); // beware singleton, not to be used
  AliQA(const ALITASK_t tsk) ;
  AliQA(const DETECTORINDEX_t det) ;
  AliQA(const AliQA& qa) ;   
  AliQA& operator = (const AliQA& qa) ;
  virtual ~AliQA();
  
  static  AliQA *        Instance() ;
  static  AliQA *        Instance(const DETECTORINDEX_t det) ;
  static  AliQA *        Instance(const ALITASK_t tsk) ;
  static  AliQA *        Instance(const TASKINDEX_t tsk) ;
  Bool_t                 CheckFatal() const ;
  static void            Close() ; 
  static const char *    GetAliTaskName(ALITASK_t tsk) ;
  static const TString   GetExpert() { return fgkExpert ; }
  static       UInt_t    GetExpertBit() { return fgkExpertBit ; }
  static const TString   GetLabLocalFile() { return fgkLabLocalFile ; } 
  static const TString   GetLabLocalOCDB() { return fgkLabLocalOCDB ; } 
  static const TString   GetLabAliEnOCDB() { return fgkLabAliEnOCDB ; } 
  static DETECTORINDEX_t GetDetIndex(const char * name) ; 
  static const TString   GetDetName(DETECTORINDEX_t det) { return fgDetNames[det] ; }
  static const char *    GetDetName(Int_t det) ;
  static const TString   GetGRPPath() { return fgGRPPath ; }  
  static       UInt_t    GetQABit() { return fgkQABit ; }
  static TFile *         GetQADataFile(const char * name, Int_t run) ; 
  static TFile *	       GetQADataFile(const char * fileName) ;
  static const char *    GetQADataFileName(const char * name, Int_t run) 
  {return Form("%s.%s.%d.root", name, fgQADataFileName.Data(), run)  ; }
  static const char *    GetQADataFileName() { return fgQADataFileName.Data() ; }
  static const char *    GetQAName() { return fgkQAName ; } 
  static const char *    GetQACorrName() { return fgkQACorrNtName ; }
  static TFile *         GetQAResultFile() ; 
  static const char  *   GetQAResultFileName() { return (fgQAResultDirName + fgQAResultFileName).Data() ; }
  static const char  *   GetQARefDefaultStorage() { return fgkQARefOCDBDefault.Data() ; }
  static const char  *   GetQARefFileName() { return fgQARefFileName ; }
  static const char  *   GetQARefStorage() { return fgQARefDirName.Data() ; }
  static const char  *   GetRefOCDBDirName() { return fgkRefOCDBDirName.Data() ; }
  static const char  *   GetRefDataDirName() { return fgRefDataDirName.Data() ; }
  static     TASKINDEX_t GetTaskIndex(const char * name) ; 
  static       TString   GetTaskName(UInt_t tsk) { return fgTaskNames[tsk] ; }
  Bool_t                 IsEventSpecieSet(AliRecoParam::EventSpecie_t es) const 
  {Int_t ibit=0; while(es!=1<<ibit) ++ibit; return fEventSpecies[ibit];}
  Bool_t                 IsEventSpecieSet(Int_t es) const { return fEventSpecies[es] ; }
  Bool_t                 IsSet(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es, QABIT_t bit) const ;
  Bool_t                 IsSet(DETECTORINDEX_t det, ALITASK_t tsk, Int_t es, QABIT_t bit) const ;
  Bool_t                 IsSetAny(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es) const ;
  Bool_t                 IsSetAny(DETECTORINDEX_t det, AliRecoParam::EventSpecie_t es) const ;
  void                   Merge(TCollection * list) ; 
  void                   Set(QABIT_t bit, AliRecoParam::EventSpecie_t es) ;
  void                   Set(QABIT_t bit, Int_t es) ;
  void                   SetEventSpecie(AliRecoParam::EventSpecie_t es) 
  {Int_t ibit=0; while(es!=1<<ibit) ++ibit; fEventSpecies[ibit] = kTRUE ; }
  static void		 SetQAResultDirName(const char * name) ; 
  static void            SetQARefStorage(const char * name) ; 
  static void            SetQARefDataDirName(AliRecoParam::EventSpecie_t es) { fgRefDataDirName = AliRecoParam::GetEventSpecieName(es) ; }
  static void            SetQARefDataDirName(Int_t es) { fgRefDataDirName = AliRecoParam::GetEventSpecieName(es) ; }
  void                   Show() const ; 
  void                   Show(DETECTORINDEX_t det) const ;
  void                   ShowAll() const ;
  void                   ShowStatus(DETECTORINDEX_t det, ALITASK_t tsk=kNULLTASK, AliRecoParam::EventSpecie_t es=AliRecoParam::kDefault) const ;
  void                   UnSet(QABIT_t bit, AliRecoParam::EventSpecie_t es) ;
  void                   UnSet(QABIT_t bit, Int_t es) ;
  
private:      
  
  Bool_t         CheckRange(DETECTORINDEX_t det) const ;
  Bool_t         CheckRange(ALITASK_t tsk) const ;
  Bool_t         CheckRange(QABIT_t bit) const ;
  Bool_t         CheckRange(AliRecoParam::EventSpecie_t es) const ;
  const char *         GetBitName(QABIT_t bit) const ;
  ULong_t        GetStatus(DETECTORINDEX_t det, AliRecoParam::EventSpecie_t es) const  { return fQA[det*fNEventSpecies+(Int_t)TMath::Log2(es)] ;}
  void                 Finish() const ;  
  ULong_t        Offset(ALITASK_t tsk) const ;
  void                 ShowASCIIStatus(AliRecoParam::EventSpecie_t es, DETECTORINDEX_t det, ALITASK_t tsk, ULong_t status) const ; 
  void                 ResetStatus(DETECTORINDEX_t det) ; 
  void                 Set(DETECTORINDEX_t det) { fDet = det ;}
  void                 Set(ALITASK_t tsk) { fTask = tsk ; AliDebug(1, Form("Ready to set QA status in %s", GetAliTaskName(tsk) )) ; }
  void                 SetStatus(DETECTORINDEX_t det, AliRecoParam::EventSpecie_t es, ULong_t status) { fQA[det*fNEventSpecies+(Int_t)TMath::Log2(es)] = status ; }
  void                 SetStatusBit(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es, QABIT_t bit) ;
  void                 UnSetStatusBit(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es, QABIT_t bit) ;
  
  static AliQA *       fgQA		                ; // pointer to the instance of the singleton
  Int_t                fNdet     	            ; // number of detectors
  Int_t                fNEventSpecies          ; // number of Event Species (see AliRecoParam)
  Int_t                fLengthQA              ; // Auxiliary length of fQA
  ULong_t    *        fQA		                ; //[fNdet][fNEventSpecie] the status word 4 bits for SIM, REC, ESD, ANA each
  DETECTORINDEX_t      fDet		                ; //! the current detector (ITS, TPC, ....)
  ALITASK_t            fTask	                ; //! the current environment (SIM, REC, ESD, ANA)
  AliRecoParam::EventSpecie_t fEventSpecie    ; //! the current event specie
  static TString       fgDetNames[]	          ; //! list of detector names   
  static TString       fgGRPPath              ; //! path of the GRP object in OCDB
  static TFile *       fgQADataFile	          ; //! the output file where the quality assurance maker store their results
  static TString       fgQADataFileName       ; //! the name of the file where the quality assurance maker store their results
  static TFile *       fgQARefFile	          ; //! the output file where the quality assurance maker store their results
  static TString       fgQARefDirName	        ; //! name of directory where to find the reference data file
  static TString       fgQARefFileName        ; //! file name where to find the reference data
  static TFile *       fgQAResultFile         ; //! File where to find the QA result
  static TString       fgQAResultDirName      ; //! the location of the output file where the QA results are stored  
  static TString       fgQAResultFileName     ; //! the output file where the QA results are stored  
  static TString       fgRTNames[]	          ; //! list of Run Type names   
  static TString       fgTaskNames[]	        ; //! list of tasks names   
  static const TString fgkExpert              ; //! name for the expert directory
  static const UInt_t  fgkExpertBit           ; //! TObject bit identifing the object as "expert"
  static const TString fgkLabLocalFile        ; //! label to identify a file as local 
  static const TString fgkLabLocalOCDB        ; //! label to identify a file as local OCDB 
  static const TString fgkLabAliEnOCDB        ; //! label to identify a file as AliEn OCDB 
  static const TString fgkRefFileName         ; //! name of Reference File Name 
  static const UInt_t  fgkQABit               ; //! bit in the QA data object which is set when Checker does not return 0
  static const TString fgkQAName              ; //! name of QA object 
  static const TString fgkQACorrNtName        ; //! name of QA Correlation Ntuple
  static const TString fgkRefOCDBDirName      ; //! name of Reference directory name in OCDB  	
  static       TString fgRefDataDirName       ; //! name of Reference directory name in OCDB for data  	
  static const TString fgkQARefOCDBDefault    ; //! default storage for QA in OCDB 
  Bool_t *             fEventSpecies          ; //[fNEventSpecies] list of event species encountered in a run

 ClassDef(AliQA,2)  //ALICE Quality Assurance Object
};
#endif
Commit	Line	Data
2e42b4d4	1	#ifndef ALIQA_H
2e42b4d4	2	#define ALIQA_H
421ab0fb	3	/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	4	* See cxx source for full Copyright notice */
	5
	6	/* $Id$ */
	7
	8	//
	9	// Quality Assurance Object
	10	//
	11
a5fa6165	12	#include <TNamed.h>
57acd2d2	13	#include <TMath.h>
421ab0fb	14	class TFile ;
421ab0fb	15
7079c8d7	16	#include "AliLog.h"
57acd2d2	17	#include "AliRecoParam.h"
7079c8d7	18
2e42b4d4	19	class AliQA : public TNamed {
421ab0fb	20	public:
3e2e3ece	21
3e2e3ece	22	enum DETECTORINDEX_t {
421ab0fb	23	kNULLDET=-1, kITS, kTPC, kTRD, kTOF, kPHOS, kHMPID, kEMCAL, kMUON, kFMD,
a2b64fbd	24	kZDC, kPMD, kT0, kVZERO, kACORDE, kHLT, kGLOBAL, kCORR, kNDET};
3e2e3ece	25	enum ALITASK_t {
4edbc5bc	26	kNULLTASK=-1, kRAW, kSIM, kREC, kESD, kANA, kNTASK };
3e2e3ece	27	enum QABIT_t {
4edbc5bc	28	kNULLBit=-1, kINFO, kWARNING, kERROR, kFATAL, kNBIT };
3e2e3ece	29	enum TASKINDEX_t {
940d8e5f	30	kNULLTASKINDEX=-1, kRAWS, kHITS, kSDIGITS, kDIGITS, kRECPOINTS, kTRACKSEGMENTS, kRECPARTICLES, kESDS, kNTASKINDEX };
421ab0fb	31
3e2e3ece	32	// Creators - destructors
	33	AliQA(); // beware singleton, not to be used
	34	AliQA(const ALITASK_t tsk) ;
	35	AliQA(const DETECTORINDEX_t det) ;
	36	AliQA(const AliQA& qa) ;
	37	AliQA& operator = (const AliQA& qa) ;
	38	virtual ~AliQA();
	39
	40	static AliQA * Instance() ;
	41	static AliQA * Instance(const DETECTORINDEX_t det) ;
	42	static AliQA * Instance(const ALITASK_t tsk) ;
	43	static AliQA * Instance(const TASKINDEX_t tsk) ;
	44	Bool_t CheckFatal() const ;
	45	static void Close() ;
	46	static const char * GetAliTaskName(ALITASK_t tsk) ;
	47	static const TString GetExpert() { return fgkExpert ; }
	48	static UInt_t GetExpertBit() { return fgkExpertBit ; }
	49	static const TString GetLabLocalFile() { return fgkLabLocalFile ; }
	50	static const TString GetLabLocalOCDB() { return fgkLabLocalOCDB ; }
	51	static const TString GetLabAliEnOCDB() { return fgkLabAliEnOCDB ; }
	52	static DETECTORINDEX_t GetDetIndex(const char * name) ;
	53	static const TString GetDetName(DETECTORINDEX_t det) { return fgDetNames[det] ; }
	54	static const char * GetDetName(Int_t det) ;
	55	static const TString GetGRPPath() { return fgGRPPath ; }
	56	static UInt_t GetQABit() { return fgkQABit ; }
	57	static TFile * GetQADataFile(const char * name, Int_t run) ;
	58	static TFile * GetQADataFile(const char * fileName) ;
	59	static const char * GetQADataFileName(const char * name, Int_t run)
	60	{return Form("%s.%s.%d.root", name, fgQADataFileName.Data(), run) ; }
	61	static const char * GetQADataFileName() { return fgQADataFileName.Data() ; }
	62	static const char * GetQAName() { return fgkQAName ; }
	63	static const char * GetQACorrName() { return fgkQACorrNtName ; }
	64	static TFile * GetQAResultFile() ;
	65	static const char * GetQAResultFileName() { return (fgQAResultDirName + fgQAResultFileName).Data() ; }
	66	static const char * GetQARefDefaultStorage() { return fgkQARefOCDBDefault.Data() ; }
	67	static const char * GetQARefFileName() { return fgQARefFileName ; }
	68	static const char * GetQARefStorage() { return fgQARefDirName.Data() ; }
	69	static const char * GetRefOCDBDirName() { return fgkRefOCDBDirName.Data() ; }
	70	static const char * GetRefDataDirName() { return fgRefDataDirName.Data() ; }
	71	static TASKINDEX_t GetTaskIndex(const char * name) ;
	72	static TString GetTaskName(UInt_t tsk) { return fgTaskNames[tsk] ; }
	73	Bool_t IsEventSpecieSet(AliRecoParam::EventSpecie_t es) const
	74	{Int_t ibit=0; while(es!=1<<ibit) ++ibit; return fEventSpecies[ibit];}
57acd2d2	75	Bool_t IsEventSpecieSet(Int_t es) const { return fEventSpecies[es] ; }
	76	Bool_t IsSet(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es, QABIT_t bit) const ;
	77	Bool_t IsSet(DETECTORINDEX_t det, ALITASK_t tsk, Int_t es, QABIT_t bit) const ;
	78	Bool_t IsSetAny(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es) const ;
	79	Bool_t IsSetAny(DETECTORINDEX_t det, AliRecoParam::EventSpecie_t es) const ;
3e2e3ece	80	void Merge(TCollection * list) ;
	81	void Set(QABIT_t bit, AliRecoParam::EventSpecie_t es) ;
	82	void Set(QABIT_t bit, Int_t es) ;
	83	void SetEventSpecie(AliRecoParam::EventSpecie_t es)
	84	{Int_t ibit=0; while(es!=1<<ibit) ++ibit; fEventSpecies[ibit] = kTRUE ; }
	85	static void SetQAResultDirName(const char * name) ;
	86	static void SetQARefStorage(const char * name) ;
	87	static void SetQARefDataDirName(AliRecoParam::EventSpecie_t es) { fgRefDataDirName = AliRecoParam::GetEventSpecieName(es) ; }
	88	static void SetQARefDataDirName(Int_t es) { fgRefDataDirName = AliRecoParam::GetEventSpecieName(es) ; }
	89	void Show() const ;
	90	void Show(DETECTORINDEX_t det) const ;
	91	void ShowAll() const ;
	92	void ShowStatus(DETECTORINDEX_t det, ALITASK_t tsk=kNULLTASK, AliRecoParam::EventSpecie_t es=AliRecoParam::kDefault) const ;
	93	void UnSet(QABIT_t bit, AliRecoParam::EventSpecie_t es) ;
	94	void UnSet(QABIT_t bit, Int_t es) ;
	95
421ab0fb	96	private:
3e2e3ece	97
	98	Bool_t CheckRange(DETECTORINDEX_t det) const ;
	99	Bool_t CheckRange(ALITASK_t tsk) const ;
	100	Bool_t CheckRange(QABIT_t bit) const ;
	101	Bool_t CheckRange(AliRecoParam::EventSpecie_t es) const ;
	102	const char * GetBitName(QABIT_t bit) const ;
	103	ULong_t GetStatus(DETECTORINDEX_t det, AliRecoParam::EventSpecie_t es) const { return fQA[det*fNEventSpecies+(Int_t)TMath::Log2(es)] ;}
	104	void Finish() const ;
	105	ULong_t Offset(ALITASK_t tsk) const ;
	106	void ShowASCIIStatus(AliRecoParam::EventSpecie_t es, DETECTORINDEX_t det, ALITASK_t tsk, ULong_t status) const ;
	107	void ResetStatus(DETECTORINDEX_t det) ;
	108	void Set(DETECTORINDEX_t det) { fDet = det ;}
	109	void Set(ALITASK_t tsk) { fTask = tsk ; AliDebug(1, Form("Ready to set QA status in %s", GetAliTaskName(tsk) )) ; }
	110	void SetStatus(DETECTORINDEX_t det, AliRecoParam::EventSpecie_t es, ULong_t status) { fQA[det*fNEventSpecies+(Int_t)TMath::Log2(es)] = status ; }
	111	void SetStatusBit(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es, QABIT_t bit) ;
	112	void UnSetStatusBit(DETECTORINDEX_t det, ALITASK_t tsk, AliRecoParam::EventSpecie_t es, QABIT_t bit) ;
	113
	114	static AliQA * fgQA ; // pointer to the instance of the singleton
	115	Int_t fNdet ; // number of detectors
	116	Int_t fNEventSpecies ; // number of Event Species (see AliRecoParam)
	117	Int_t fLengthQA ; // Auxiliary length of fQA
	118	ULong_t * fQA ; //[fNdet][fNEventSpecie] the status word 4 bits for SIM, REC, ESD, ANA each
	119	DETECTORINDEX_t fDet ; //! the current detector (ITS, TPC, ....)
	120	ALITASK_t fTask ; //! the current environment (SIM, REC, ESD, ANA)
57acd2d2	121	AliRecoParam::EventSpecie_t fEventSpecie ; //! the current event specie
3e2e3ece	122	static TString fgDetNames[] ; //! list of detector names
	123	static TString fgGRPPath ; //! path of the GRP object in OCDB
	124	static TFile * fgQADataFile ; //! the output file where the quality assurance maker store their results
	125	static TString fgQADataFileName ; //! the name of the file where the quality assurance maker store their results
	126	static TFile * fgQARefFile ; //! the output file where the quality assurance maker store their results
	127	static TString fgQARefDirName ; //! name of directory where to find the reference data file
	128	static TString fgQARefFileName ; //! file name where to find the reference data
	129	static TFile * fgQAResultFile ; //! File where to find the QA result
	130	static TString fgQAResultDirName ; //! the location of the output file where the QA results are stored
	131	static TString fgQAResultFileName ; //! the output file where the QA results are stored
	132	static TString fgRTNames[] ; //! list of Run Type names
	133	static TString fgTaskNames[] ; //! list of tasks names
	134	static const TString fgkExpert ; //! name for the expert directory
	135	static const UInt_t fgkExpertBit ; //! TObject bit identifing the object as "expert"
	136	static const TString fgkLabLocalFile ; //! label to identify a file as local
	137	static const TString fgkLabLocalOCDB ; //! label to identify a file as local OCDB
	138	static const TString fgkLabAliEnOCDB ; //! label to identify a file as AliEn OCDB
	139	static const TString fgkRefFileName ; //! name of Reference File Name
	140	static const UInt_t fgkQABit ; //! bit in the QA data object which is set when Checker does not return 0
	141	static const TString fgkQAName ; //! name of QA object
	142	static const TString fgkQACorrNtName ; //! name of QA Correlation Ntuple
	143	static const TString fgkRefOCDBDirName ; //! name of Reference directory name in OCDB
	144	static TString fgRefDataDirName ; //! name of Reference directory name in OCDB for data
	145	static const TString fgkQARefOCDBDefault ; //! default storage for QA in OCDB
360e1aa3	146	Bool_t * fEventSpecies ; //[fNEventSpecies] list of event species encountered in a run
2e42b4d4	147
3e2e3ece	148	ClassDef(AliQA,2) //ALICE Quality Assurance Object
421ab0fb	149	};
421ab0fb	150	#endif