[u/mrichter/AliRoot.git] / TRD / AliTRDcalibDB.h

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

///////////////////////////////////////////////////////////////////////////////
//                                                                           //
// Class providing the calibration parameters by accessing the CDB           //
//                                                                           //
///////////////////////////////////////////////////////////////////////////////

/* $Id$ */

#ifndef ROOT_TObject
#include "TObject.h"
#endif

#ifndef ALITRDPIDUTIL_H
#include "AliTRDpidUtil.h"
#endif

#ifndef ALITRDPIDRESPONSE_H
#include "AliTRDPIDResponse.h"
#endif

#include "AliTRDCalTrapConfig.h"
#include "AliTRDtrapConfig.h"

class TString;

class AliCDBEntry;

class AliTRDrecoParam;
class AliTRDCalTrkAttach;
class AliTRDCalPID;
class AliTRDCalMonitoring;
class AliTRDCalROC;
class AliTRDCalDet;
class AliTRDCalSingleChamberStatus;
class AliTRDCalOnlineGainTableROC;

class AliTRDcalibDB : public TObject {

 public:

  enum { kNlayer  =   6
       , kNstack  =   5
       , kNsector =  18
       , kNdet    = 540 };
  
  enum { kFltrSet = 1
       , kReadout
       , kTimebin
       , kTrkMode
       , kTrigSet
       , kAddOpti };

  static AliTRDcalibDB               *Instance();
  static void                         Terminate();
  virtual                            ~AliTRDcalibDB();
  void                                SetRun(Long64_t run);
  Long64_t                            GetRun() const { return fRun; }

  Float_t                             GetNoise(Int_t det, Int_t col, Int_t row);
        AliTRDCalROC                 *GetNoiseROC(Int_t det);
  const AliTRDCalDet                 *GetNoiseDet();

  Float_t                             GetVdrift(Int_t det, Int_t col, Int_t row);
  Float_t                             GetVdriftAverage(Int_t det);
        AliTRDCalROC                 *GetVdriftROC(Int_t det);
  const AliTRDCalDet                 *GetVdriftDet();
  TObjArray                          *GetPHQ();
  const AliTRDCalDet                 *GetExBDet();

  Float_t                             GetT0(Int_t det, Int_t col, Int_t row);
  Float_t                             GetT0Average(Int_t det);
        AliTRDCalROC                 *GetT0ROC(Int_t det);
  const AliTRDCalDet                 *GetT0Det();

  Float_t                             GetGainFactor(Int_t det, Int_t col, Int_t row);
  Float_t                             GetGainFactorAverage(Int_t det);
  AliTRDCalROC                       *GetGainFactorROC(Int_t det);
  const AliTRDCalDet                 *GetGainFactorDet();

  Float_t                             GetOnlineGainFactor(Int_t det, Int_t col, Int_t row);
  AliTRDCalOnlineGainTableROC        *GetOnlineGainTableROC(Int_t det);

  AliTRDCalROC                       *GetPRFROC(Int_t det);
  Float_t                             GetPRFWidth(Int_t det, Int_t col, Int_t row);

  Float_t*                            GetSampledPRF() const { return fPRFsmp; };
  Int_t                               GetPRFbin() const     { return fPRFbin; };
  Float_t                             GetPRFlo() const      { return fPRFlo;  };
  Float_t                             GetPRFhi() const      { return fPRFhi;  };

  Int_t                               ExtractTimeBinsFromString(TString tbstr);
  Int_t                               GetNumberOfTimeBinsDCS();
  void                                GetFilterType(TString &filterType);
  void                                GetGlobalConfiguration(TString &config);
  void                                GetGlobalConfigurationByChamber(TString &config,Int_t par, Int_t opt=0);
  void                                GetGlobalConfigurationVersion(TString &version);
  Int_t                               GetNumberOfParsDCS(TString cname, Char_t delimiter='_');
  Int_t                               GetNumberOfOptsDCS(TString cname, Int_t cfgType);
  void                                GetDCSConfigParOption(TString cname, Int_t cfgType, Int_t option, TString &cfgo);

  Int_t                               GetOnlineGainTableID();

  Bool_t                              HasOnlineFilterPedestal();
  Bool_t                              HasOnlineFilterGain();
  Bool_t                              HasOnlineTailCancellation();

  Char_t                              GetPadStatus(Int_t det, Int_t col, Int_t row);
  AliTRDCalSingleChamberStatus       *GetPadStatusROC(Int_t det);
  AliTRDrecoParam*                    GetRecoParam(Int_t *eventtype);
  AliTRDPIDResponse                  *GetPIDResponse(AliTRDPIDResponse::ETRDPIDMethod m);

  Char_t                              GetChamberStatus(Int_t det);

  Bool_t                              IsPadMasked(Int_t det, Int_t col, Int_t row);
  Bool_t                              IsPadBridgedLeft(Int_t det, Int_t col, Int_t row);
  Bool_t                              IsPadBridgedRight(Int_t det, Int_t col, Int_t row);
  Bool_t                              IsPadNotConnected(Int_t det, Int_t col, Int_t row);
  
  Bool_t                              IsChamberGood(Int_t det);
  Bool_t                              IsChamberNoData(Int_t det);
  Bool_t                              IsHalfChamberNoData(Int_t det, Int_t side);
  Bool_t                              IsChamberBadCalibrated(Int_t det);
  Bool_t                              IsChamberNotCalibrated(Int_t det);

  const AliTRDCalMonitoring          *GetMonitoringObject();
  const AliTRDCalPID                 *GetPIDObject(AliTRDpidUtil::ETRDPIDMethod m);
  const AliTRDCalTrkAttach           *GetAttachObject();

  // Related functions, these depend on calibration data
  Int_t                               PadResponse(Double_t signal, Double_t dist
                                                , Int_t layer, Double_t *pad) const;

  AliTRDtrapConfig*                   GetTrapConfig();
  void                                GetTrapConfig(TString &name, TString &version) { name = fTrapConfigName; version = fTrapConfigVersion; }
  void                                SetTrapConfig(const TString name, const TString version) { fTrapConfigName = name; fTrapConfigVersion = version; }
  void                                SetTrapConfig(AliTRDtrapConfig *trapcfg) { fTrapConfig = trapcfg; }

 protected:

  AliTRDtrapConfig*                   LoadTrapConfig(const TString &name = "", const TString &version = "");
  Int_t                               GetNumberOfTimeBinsDCSBoard(); // Old method as fallback for patched OCDB 

  // For caching see also implentation of GetCachedCDBObject in the .cxx file
  enum { kIDVdriftPad = 0
       , kIDVdriftChamber
       , kIDExBChamber
       , kIDT0Pad
       , kIDT0Chamber
       , kIDGainFactorPad
       , kIDGainFactorChamber
       , kIDOnlineGainFactor
       , kIDNoiseChamber
       , kIDNoisePad
       , kIDPRFWidth
       , kIDFEE
       , kIDTrapConfig
       , kIDChamberPos
       , kIDStackPos
       , kIDSuperModulePos
       , kIDPIDNN
       , kIDPIDLQ
       , kIDPIDLQ1D
       , kIDRecoParam
       , kIDMonitoringData
       , kIDChamberStatus
       , kIDPadStatus
       , kIDDCS
       , kIDAttach
       , kIDPHQ
       , kCDBCacheSize };         // IDs of cached objects

  const TObject *GetCachedCDBObject(Int_t id);
  
  void           Invalidate();
  void           SamplePRF();
  
  AliCDBEntry   *GetCDBEntry(const Char_t *cdbPath);
  const TObject *CacheCDBEntry(Int_t id, const Char_t *cdbPath);

  static AliTRDcalibDB *fgInstance;                 //  Instance of this class (singleton implementation)
  static Bool_t         fgTerminated;               //  Defines if this class has already been terminated

  AliCDBEntry          *fCDBEntries[kCDBCacheSize]; //  Cache for CDB entries
  TObject              *fCDBCache[kCDBCacheSize];   //  Cache for calibration objects.

  Long64_t              fRun;                       //  Run Number

  Float_t              *fPRFsmp;                    //! Sampled pad response
  Int_t                 fPRFbin;                    //  Number of bins for the PRF
  Float_t               fPRFlo;                     //  Lower boundary of the PRF
  Float_t               fPRFhi;                     //  Higher boundary of the PRF
  Float_t               fPRFwid;                    //  Bin width of the sampled PRF
  Int_t                 fPRFpad;                    //  Distance to next pad in PRF

  AliTRDPIDResponse    *fPIDResponse;               //  TRD PID Response function

  Int_t                 fOnlineGainTableID;         //  ID for online gain table 

  AliTRDtrapConfig*     fTrapConfig;                //  TRAP configuration
  TString               fTrapConfigName;            //  name of the TRAPconfig
  TString               fTrapConfigVersion;         //  version of the TRAPconfig
  
 private:

  AliTRDcalibDB();                                  //  This is a singleton, constructor is private!  
  AliTRDcalibDB(const AliTRDcalibDB &c);   
  AliTRDcalibDB &operator=(const AliTRDcalibDB &c); 

  ClassDef(AliTRDcalibDB, 8)                        //  Provides central access to the CDB

};

#endif
Commit	Line	Data
3551db50	1	#ifndef ALITRDCALIBDB_H
	2	#define ALITRDCALIBDB_H
	3	/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	4	* See cxx source for full Copyright notice */
	5
	6	///////////////////////////////////////////////////////////////////////////////
	7	// //
	8	// Class providing the calibration parameters by accessing the CDB //
	9	// //
	10	///////////////////////////////////////////////////////////////////////////////
	11
	12	/* $Id$ */
	13
4ba1d6ae	14	#ifndef ROOT_TObject
3551db50	15	#include "TObject.h"
4ba1d6ae	16	#endif
4ba1d6ae	17
0d83b3a5	18	#ifndef ALITRDPIDUTIL_H
0d83b3a5	19	#include "AliTRDpidUtil.h"
4ba1d6ae	20	#endif
3551db50	21
9dcc64cc	22	#ifndef ALITRDPIDRESPONSE_H
	23	#include "AliTRDPIDResponse.h"
	24	#endif
	25
a9e22145	26	#include "AliTRDCalTrapConfig.h"
	27	#include "AliTRDtrapConfig.h"
	28
ea3eaa08	29	class TString;
ea3eaa08	30
2745a409	31	class AliCDBEntry;
3551db50	32
0d83b3a5	33	class AliTRDrecoParam;
9dcc64cc	34	class AliTRDCalTrkAttach;
720a0a16	35	class AliTRDCalPID;
7754cd1f	36	class AliTRDCalMonitoring;
56178ff4	37	class AliTRDCalROC;
56178ff4	38	class AliTRDCalDet;
0e09df31	39	class AliTRDCalSingleChamberStatus;
ea3eaa08	40	class AliTRDCalOnlineGainTableROC;
ea3eaa08	41
2745a409	42	class AliTRDcalibDB : public TObject {
	43
	44	public:
	45
053767a4	46	enum { kNlayer = 6
	47	, kNstack = 5
	48	, kNsector = 18
	49	, kNdet = 540 };
6a739e92	50
fc358d0f	51	enum { kFltrSet = 1
	52	, kReadout
	53	, kTimebin
	54	, kTrkMode
	55	, kTrigSet
	56	, kAddOpti };
	57
0e09df31	58	static AliTRDcalibDB *Instance();
0e09df31	59	static void Terminate();
542f5ad1	60	virtual ~AliTRDcalibDB();
0e09df31	61	void SetRun(Long64_t run);
0e09df31	62	Long64_t GetRun() const { return fRun; }
7754cd1f	63
df83a620	64	Float_t GetNoise(Int_t det, Int_t col, Int_t row);
	65	AliTRDCalROC *GetNoiseROC(Int_t det);
	66	const AliTRDCalDet *GetNoiseDet();
	67
0e09df31	68	Float_t GetVdrift(Int_t det, Int_t col, Int_t row);
	69	Float_t GetVdriftAverage(Int_t det);
	70	AliTRDCalROC *GetVdriftROC(Int_t det);
	71	const AliTRDCalDet *GetVdriftDet();
e2a1c98b	72	TObjArray *GetPHQ();
eda91732	73	const AliTRDCalDet *GetExBDet();
eda91732	74
0e09df31	75	Float_t GetT0(Int_t det, Int_t col, Int_t row);
	76	Float_t GetT0Average(Int_t det);
	77	AliTRDCalROC *GetT0ROC(Int_t det);
	78	const AliTRDCalDet *GetT0Det();
7754cd1f	79
0e09df31	80	Float_t GetGainFactor(Int_t det, Int_t col, Int_t row);
0e09df31	81	Float_t GetGainFactorAverage(Int_t det);
4ba1d6ae	82	AliTRDCalROC *GetGainFactorROC(Int_t det);
0e09df31	83	const AliTRDCalDet *GetGainFactorDet();
3551db50	84
ea3eaa08	85	Float_t GetOnlineGainFactor(Int_t det, Int_t col, Int_t row);
	86	AliTRDCalOnlineGainTableROC *GetOnlineGainTableROC(Int_t det);
	87
4ba1d6ae	88	AliTRDCalROC *GetPRFROC(Int_t det);
0e09df31	89	Float_t GetPRFWidth(Int_t det, Int_t col, Int_t row);
7754cd1f	90
be28462a	91	Float_t* GetSampledPRF() const { return fPRFsmp; };
	92	Int_t GetPRFbin() const { return fPRFbin; };
	93	Float_t GetPRFlo() const { return fPRFlo; };
	94	Float_t GetPRFhi() const { return fPRFhi; };
fa7427d0	95
5b7ccf04	96	Int_t ExtractTimeBinsFromString(TString tbstr);
e232d349	97	Int_t GetNumberOfTimeBinsDCS();
e232d349	98	void GetFilterType(TString &filterType);
af086c5e	99	void GetGlobalConfiguration(TString &config);
01bf853b	100	void GetGlobalConfigurationByChamber(TString &config,Int_t par, Int_t opt=0);
f8059b39	101	void GetGlobalConfigurationVersion(TString &version);
1567d9a4	102	Int_t GetNumberOfParsDCS(TString cname, Char_t delimiter='_');
5b7ccf04	103	Int_t GetNumberOfOptsDCS(TString cname, Int_t cfgType);
5b7ccf04	104	void GetDCSConfigParOption(TString cname, Int_t cfgType, Int_t option, TString &cfgo);
ea3eaa08	105
	106	Int_t GetOnlineGainTableID();
	107
af086c5e	108	Bool_t HasOnlineFilterPedestal();
	109	Bool_t HasOnlineFilterGain();
	110	Bool_t HasOnlineTailCancellation();
7754cd1f	111
0e09df31	112	Char_t GetPadStatus(Int_t det, Int_t col, Int_t row);
4ba1d6ae	113	AliTRDCalSingleChamberStatus *GetPadStatusROC(Int_t det);
a7ac01d2	114	AliTRDrecoParam* GetRecoParam(Int_t *eventtype);
9dcc64cc	115	AliTRDPIDResponse *GetPIDResponse(AliTRDPIDResponse::ETRDPIDMethod m);
7754cd1f	116
0e09df31	117	Char_t GetChamberStatus(Int_t det);
	118
	119	Bool_t IsPadMasked(Int_t det, Int_t col, Int_t row);
	120	Bool_t IsPadBridgedLeft(Int_t det, Int_t col, Int_t row);
	121	Bool_t IsPadBridgedRight(Int_t det, Int_t col, Int_t row);
fa7427d0	122	Bool_t IsPadNotConnected(Int_t det, Int_t col, Int_t row);
3551db50	123
eda91732	124	Bool_t IsChamberGood(Int_t det);
	125	Bool_t IsChamberNoData(Int_t det);
	126	Bool_t IsHalfChamberNoData(Int_t det, Int_t side);
	127	Bool_t IsChamberBadCalibrated(Int_t det);
67abca5c	128	Bool_t IsChamberNotCalibrated(Int_t det);
7754cd1f	129
0e09df31	130	const AliTRDCalMonitoring *GetMonitoringObject();
0d83b3a5	131	const AliTRDCalPID *GetPIDObject(AliTRDpidUtil::ETRDPIDMethod m);
9dcc64cc	132	const AliTRDCalTrkAttach *GetAttachObject();
7754cd1f	133
2745a409	134	// Related functions, these depend on calibration data
ea3eaa08	135	Int_t PadResponse(Double_t signal, Double_t dist
053767a4	136	, Int_t layer, Double_t *pad) const;
543691ea	137
a9e22145	138	AliTRDtrapConfig* GetTrapConfig();
1b1afdd3	139	void GetTrapConfig(TString &name, TString &version) { name = fTrapConfigName; version = fTrapConfigVersion; }
1b1afdd3	140	void SetTrapConfig(const TString name, const TString version) { fTrapConfigName = name; fTrapConfigVersion = version; }
a9e22145	141	void SetTrapConfig(AliTRDtrapConfig *trapcfg) { fTrapConfig = trapcfg; }
a9e22145	142
2745a409	143	protected:
2745a409	144
1b1afdd3	145	AliTRDtrapConfig* LoadTrapConfig(const TString &name = "", const TString &version = "");
01bf853b	146	Int_t GetNumberOfTimeBinsDCSBoard(); // Old method as fallback for patched OCDB
1b1afdd3	147
2745a409	148	// For caching see also implentation of GetCachedCDBObject in the .cxx file
b43a3e17	149	enum { kIDVdriftPad = 0
b43a3e17	150	, kIDVdriftChamber
eda91732	151	, kIDExBChamber
b43a3e17	152	, kIDT0Pad
	153	, kIDT0Chamber
	154	, kIDGainFactorPad
	155	, kIDGainFactorChamber
ea3eaa08	156	, kIDOnlineGainFactor
df83a620	157	, kIDNoiseChamber
df83a620	158	, kIDNoisePad
b43a3e17	159	, kIDPRFWidth
aa617684	160	, kIDFEE
a9e22145	161	, kIDTrapConfig
b43a3e17	162	, kIDChamberPos
	163	, kIDStackPos
	164	, kIDSuperModulePos
44dbae42	165	, kIDPIDNN
b43a3e17	166	, kIDPIDLQ
9dcc64cc	167	, kIDPIDLQ1D
a7ac01d2	168	, kIDRecoParam
b43a3e17	169	, kIDMonitoringData
b43a3e17	170	, kIDChamberStatus
913950a4	171	, kIDPadStatus
d6a1ec13	172	, kIDDCS
9dcc64cc	173	, kIDAttach
e2a1c98b	174	, kIDPHQ
d6a1ec13	175	, kCDBCacheSize }; // IDs of cached objects
7754cd1f	176
56178ff4	177	const TObject *GetCachedCDBObject(Int_t id);
3551db50	178
2745a409	179	void Invalidate();
2745a409	180	void SamplePRF();
6a739e92	181
b43a3e17	182	AliCDBEntry GetCDBEntry(const Char_t cdbPath);
b43a3e17	183	const TObject CacheCDBEntry(Int_t id, const Char_t cdbPath);
7754cd1f	184
2745a409	185	static AliTRDcalibDB *fgInstance; // Instance of this class (singleton implementation)
2745a409	186	static Bool_t fgTerminated; // Defines if this class has already been terminated
6d50f529	187
2745a409	188	AliCDBEntry *fCDBEntries[kCDBCacheSize]; // Cache for CDB entries
2745a409	189	TObject *fCDBCache[kCDBCacheSize]; // Cache for calibration objects.
6a739e92	190
2745a409	191	Long64_t fRun; // Run Number
ea3eaa08	192
6d50f529	193	Float_t *fPRFsmp; //! Sampled pad response
	194	Int_t fPRFbin; // Number of bins for the PRF
	195	Float_t fPRFlo; // Lower boundary of the PRF
	196	Float_t fPRFhi; // Higher boundary of the PRF
	197	Float_t fPRFwid; // Bin width of the sampled PRF
	198	Int_t fPRFpad; // Distance to next pad in PRF
ea3eaa08	199
9dcc64cc	200	AliTRDPIDResponse *fPIDResponse; // TRD PID Response function
ea3eaa08	201
ea3eaa08	202	Int_t fOnlineGainTableID; // ID for online gain table
a9e22145	203
a9e22145	204	AliTRDtrapConfig* fTrapConfig; // TRAP configuration
1b1afdd3	205	TString fTrapConfigName; // name of the TRAPconfig
1b1afdd3	206	TString fTrapConfigVersion; // version of the TRAPconfig
6a739e92	207
2745a409	208	private:
	209
	210	AliTRDcalibDB(); // This is a singleton, constructor is private!
	211	AliTRDcalibDB(const AliTRDcalibDB &c);
	212	AliTRDcalibDB &operator=(const AliTRDcalibDB &c);
3551db50	213
1b1afdd3	214	ClassDef(AliTRDcalibDB, 8) // Provides central access to the CDB
2745a409	215
3551db50	216	};
3551db50	217
3551db50	218	#endif
7a6352a6	219