Adding missing comments
[u/mrichter/AliRoot.git] / MUON / AliMUONTriggerEfficiencyCells.h
1 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
2  * See cxx source for full Copyright notice                               */
3
4 /// \ingroup calib
5 /// \class AliMUONTriggerEfficiencyCells
6 /// \brief Store and give access to the trigger chamber efficiency.
7 ///
8 //  Author: Diego Stocco; INFN Torino
9
10 #ifndef ALIMUONTRIGGEREFFICIENCYCELLS_H
11 #define ALIMUONTRIGGEREFFICIENCYCELLS_H
12
13 #include "TObject.h"
14 #include "TArrayF.h"
15 #include "TArrayI.h"
16 #include "TVector2.h"
17 #include "TMatrix.h"
18 #include "TH1F.h"
19 #include "TList.h"
20
21 class AliMUONTriggerEfficiencyCells : public TObject
22 {
23 public:
24   AliMUONTriggerEfficiencyCells();
25   AliMUONTriggerEfficiencyCells(const Char_t* filename);
26   AliMUONTriggerEfficiencyCells(TList *countHistoList, TList *noCountHistoList);
27
28   AliMUONTriggerEfficiencyCells(const AliMUONTriggerEfficiencyCells& other); // copy constructor
29   AliMUONTriggerEfficiencyCells& operator=(const AliMUONTriggerEfficiencyCells& other); // assignment operator
30
31   virtual ~AliMUONTriggerEfficiencyCells();
32
33   void GetCellEfficiency(Int_t detElemId, Float_t x, Float_t y, Float_t &eff1, Float_t &eff2) const;
34   void GetCellEfficiency(Int_t detElemId, Int_t localBoard, Float_t &eff1, Float_t &eff2) const;
35     
36   void IsTriggered(Int_t detElemId, Float_t x, Float_t y, Bool_t &trig1, Bool_t &trig2) const;
37   void IsTriggered(Int_t detElemId, Int_t localBoard, Bool_t &trig1, Bool_t &trig2) const;
38
39   void DisplayEfficiency(Bool_t perSlat=kFALSE, const Char_t* geoFilename="geometry.root");
40   Bool_t SumRunEfficiency(const AliMUONTriggerEfficiencyCells &other);
41
42   /// Set the list of fired strips
43   void SetFiredStrips(TList *firedStrips){fFiredStrips = firedStrips;}
44   void CheckFiredStrips(const Char_t *geoFilename="geometry.root");
45                                 // Check for strips with lower counts than others:
46                                 // syntomatic of possible read-out problems in boards
47   void Reset();
48     
49 protected:
50     TArrayI CellByCoord(Int_t detElemId, Float_t x, Float_t y) const;
51     TVector2 ChangeReferenceFrame(Float_t x, Float_t y, Float_t x0, Float_t y0);
52     void ReadFile(const Char_t* filename="$ALICE_ROOT/MUON/data/efficiencyCells.dat");
53     void CalculateEfficiency(Int_t trigger44, Int_t trigger34,
54                              Float_t &efficiency, Float_t &error,
55                              Bool_t failuresAsInput);
56
57
58 private:
59     void CheckConstants() const;
60     Int_t FindChamberIndex(Int_t detElemId) const;
61     Int_t FindSlatIndex(Int_t detElemId) const;
62     void ReadFileXY(ifstream &file);
63     void ReadFileBoards(ifstream &file);
64     void ReadHistoBoards(const Char_t* filename="MUON.TriggerEfficiencyMap.root");
65     void InitHistos();
66     void FillHistosFromList();
67     Bool_t GetListsForCheck(const Char_t* geoFilename="geometry.root");
68     
69     static const Int_t fgkNcells=80;   ///< Number of cells
70     static const Int_t fgkNcathodes=2; ///<Number of cathodes
71     static const Int_t fgkNchambers=4; ///<Number of chambers
72     static const Int_t fgkNplanes=8;   ///<Number of planes
73     static const Int_t fgkNslats=18;   ///<Number of slats
74
75     
76     TMatrixF fCellContent[fgkNplanes][fgkNslats]; ///< the cells content
77     TArrayF  fCellSize[fgkNplanes];    ///< the size of the cells
78     TArrayI  fCellNumber[fgkNplanes];  ///< id of the cells
79     
80     TH1F *fBoardEfficiency[fgkNplanes];///< the boards content
81     TH1F *fSlatEfficiency[fgkNplanes];///< the slats content
82
83     TList *fCountHistoList; ///<list of efficiency numerators
84     TList *fNoCountHistoList; ///<list of efficiency denominators
85     TList *fFiredStrips; ///<list of fired strips for efficiency check
86
87     TList *fDisplayHistoList; //!< list of efficiency histograms for display
88     TList *fBoardLabelList; //!< list of board labels for display
89     TList *fFiredFitHistoList; //!< list of fired strips for checks
90     TList *fFiredDisplayHistoList; //!< list of fired strips for display
91
92     ClassDef(AliMUONTriggerEfficiencyCells,5) // Trigger efficiency store
93 };
94 #endif