[u/mrichter/AliRoot.git] / EMCAL / AliEMCALTrigger.h

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

/* $Id$ */

//___________________________________________________________
//  Class for trigger analysis.
//
//  -- Author: Gustavo Conesa & Yves Schutz (IFIC, SUBATECH, CERN)
//  Digits are grouped in TRU's (Trigger Units). A TRU consist of 384 cells 
//  ordered fNTRUPhi x fNTRUEta matrix. The algorithm searches all possible 
//  2x2 and nxn (n multiple of 4) crystal combinations per each TRU, adding the 
//  digits amplitude and finding the maximum.  It is found is maximum is isolated. 
//  Maxima are transformed in adc time samples. Each time bin is compared to the 
//  trigger threshold until it is larger and then, triggers are set. 
//  Thresholds need to be fixed. 
//  Last 2 modules are half size in Phi, I considered that the number 
//  of TRU is maintained for the last modules but final decision has not 
//  been taken. If different, then this must to be changed. 
//  Usage:
//
//  //Inside the event loop
//  AliEMCALTrigger *tr = new AliEMCALTrigger();//Init Trigger
//  tr->SetL0Threshold(100);
//  tr->SetL1JetLowPtThreshold(1000);
//  tr->SetL1JetMediumPtThreshold(10000);
//  tr->SetL1JetHighPtThreshold(20000);
//  ....
//  tr->Trigger(); //Execute Trigger
//  tr->Print("");  //Print data members after calculation.
//
//*-- Author: Gustavo Conesa & Yves Schutz (IFIC, SUBATECH, CERN)
     
// --- ROOT system ---

class TClonesArray ;
#include "TMatrixD.h"

// --- AliRoot header files ---
#include "AliTriggerDetector.h"

class AliEMCALGeometry ;

class AliEMCALTrigger : public AliTriggerDetector {
  
 public:   

  AliEMCALTrigger() ; //  ctor
  AliEMCALTrigger(const AliEMCALTrigger & trig) ; // cpy ctor
  virtual ~AliEMCALTrigger(); //virtual dtor


  virtual void    CreateInputs(); //Define trigger inputs for Central Trigger Processor
  void            Print(const Option_t * opt ="") const ;  
  virtual void    Trigger();  //Make EMCAL trigger

  //assignment operator for coding convention
  const AliEMCALTrigger & operator = (const AliEMCALTrigger & ) {return *this;}

  //Getters
  Float_t  Get2x2MaxAmplitude()  const { return f2x2MaxAmp ; }
  Float_t  GetnxnMaxAmplitude()  const { return fnxnMaxAmp ; }
  Int_t    Get2x2CellPhi()       const { return f2x2CellPhi ; }
  Int_t    GetnxnCellPhi()       const { return fnxnCellPhi ; }
  Int_t    Get2x2CellEta()       const { return f2x2CellEta ; }
  Int_t    GetnxnCellEta()       const { return fnxnCellEta ; }
  Int_t    Get2x2SuperModule()   const { return f2x2SM ; }
  Int_t    GetnxnSuperModule()   const { return fnxnSM ; }

  Int_t *  GetADCValuesLowGainMax2x2Sum()  { return fADCValuesLow2x2; }
  Int_t *  GetADCValuesHighGainMax2x2Sum() { return fADCValuesHigh2x2; }
  Int_t *  GetADCValuesLowGainMaxnxnSum()  { return fADCValuesLownxn; }
  Int_t *  GetADCValuesHighGainMaxnxnSum() { return fADCValuesHighnxn; }

  Float_t  GetL0Threshold() const            { return fL0Threshold ; } 
  Float_t  GetL1JetLowPtThreshold()    const { return fL1JetLowPtThreshold ; }
  Float_t  GetL1JetMediumPtThreshold() const { return fL1JetMediumPtThreshold ; }
  Float_t  GetL1JetHighPtThreshold()   const { return fL1JetHighPtThreshold ; }

  Int_t    GetPatchSize()              const { return fPatchSize ; }
  Int_t    GetIsolPatchSize()          const { return fIsolPatchSize ; }

  Float_t  Get2x2AmpOutOfPatch()       const { return  f2x2AmpOutOfPatch ; }
  Float_t  GetnxnAmpOutOfPatch()       const { return  fnxnAmpOutOfPatch ; }
  Float_t  Get2x2AmpOutOfPatchThres()  const { return  f2x2AmpOutOfPatchThres ; }
  Float_t  GetnxnAmpOutOfPatchThres()  const { return  fnxnAmpOutOfPatchThres ; } 

  Bool_t   Is2x2Isol()                 const { return  fIs2x2Isol ; }
  Bool_t   IsnxnIsol()                 const { return  fIsnxnIsol ; }

  Bool_t   IsSimulation()              const { return fSimulation ; }
  Bool_t   IsIsolatedInSuperModule()   const { return fIsolateInSuperModule ; }

  //Setters
  void     SetDigitsList(TClonesArray * digits)          
   {fDigitsList  = digits ; }

  void     SetL0Threshold(Int_t amp)     
    {fL0Threshold            = amp; }
  void     SetL1JetLowPtThreshold(Int_t amp) 
    {fL1JetLowPtThreshold    = amp; } 
  void     SetL1JetMediumPtThreshold(Int_t amp) 
    {fL1JetMediumPtThreshold = amp; } 
  void     SetL1JetHighPtThreshold(Int_t amp)
    {fL1JetHighPtThreshold   = amp; }

  void SetPatchSize(Int_t ps)                {fPatchSize = ps ; }
  void SetIsolPatchSize(Int_t ps)          {fIsolPatchSize = ps ; }
  void Set2x2AmpOutOfPatchThres(Float_t th) { f2x2AmpOutOfPatchThres = th; }
  void SetnxnAmpOutOfPatchThres(Float_t th) { fnxnAmpOutOfPatchThres = th; }
  void SetSimulation(Bool_t sim )          {fSimulation = sim ; }
  void SetIsolateInSuperModule(Bool_t isol )          {fIsolateInSuperModule = isol ; }

 private:

  void FillTRU(const AliEMCALGeometry *geom, const TClonesArray * digits, TClonesArray * ampmatrix, TClonesArray * ampmatrixsmod, TClonesArray * timeRmatrix); 

  Bool_t IsPatchIsolated(Int_t iPatchType, const TClonesArray * ampmods, const Int_t imod, const Int_t mtru, const Float_t maxamp, const Int_t maxphi, const Int_t maxeta) ;
  
  void MakeSlidingCell(const TClonesArray * amptrus, const TClonesArray * timeRtrus,const Int_t supermod, TMatrixD &ampmax2, TMatrixD &ampmaxn) ; 
  
  void SetTriggers(const TClonesArray * amptrus,const Int_t iSM, const TMatrixD &ampmax2, const TMatrixD &ampmaxn, const AliEMCALGeometry * geom) ;
  

 private: 

  Float_t f2x2MaxAmp ;         //! Maximum 2x2 added amplitude (not overlapped) 
  Int_t   f2x2CellPhi ;        //! upper right cell, row(phi)   
  Int_t   f2x2CellEta ;        //! and column(eta)  
  Int_t   f2x2SM ;             //! Super Module where maximum is found
  Float_t fnxnMaxAmp ;         //! Maximum nxn added amplitude (overlapped)
  Int_t   fnxnCellPhi ;        //! upper right cell, row(phi)   
  Int_t   fnxnCellEta ;        //! and column(eta)
  Int_t   fnxnSM ;             //! Super Module where maximum is found

  Int_t*   fADCValuesHighnxn ; //! Sampled ADC high gain values for the nxn crystals amplitude sum
  Int_t*   fADCValuesLownxn  ; //! " low gain  " 
  Int_t*   fADCValuesHigh2x2 ; //! " high gain " 2x2 "
  Int_t*   fADCValuesLow2x2  ; //! " low gaing " "

  TClonesArray* fDigitsList ;  //Array of digits 

  Float_t fL0Threshold ;            //! L0 trigger energy threshold
  Float_t fL1JetLowPtThreshold ;    //! L1 Low pT trigger energy threshold
  Float_t fL1JetMediumPtThreshold ; //! L1 Medium pT trigger energy threshold
  Float_t fL1JetHighPtThreshold ;   //! L1 High pT trigger energy threshold

  Int_t   fNTRU;             //! Number of TRU per SuperModule (3)
  Int_t   fNTRUEta ;         //! Number of crystal rows per Eta in one TRU (3)
  Int_t   fNTRUPhi ;         //! Number of crystal rows per Phi in one TRU (1)
  Int_t   fNCellsPhi;        //! Number of rows in a TRU (24)
  Int_t   fNCellsEta;        //! Number of columns in a TRU (16)

  Int_t fPatchSize;          //! Trigger patch factor, to be multiplied to 2x2 cells
                             //  0 means 2x2, 1 means 4x4, 2 means 6x6 ...
  Int_t fIsolPatchSize ;     //  Isolation patch size, number of rows or columns to add to 
                             //  the 2x2 or nxn maximum amplitude patch. 
                             //  1 means a patch around max amplitude of 2x2 of 4x4 and around         
                             //  max ampl patch of 4x4 of 8x8 
    
  Float_t f2x2AmpOutOfPatch;      //  Amplitude in isolation cone minus maximum amplitude of the reference patch
  Float_t fnxnAmpOutOfPatch; 
  Float_t f2x2AmpOutOfPatchThres; //  Threshold to select a trigger as isolated on f2x2AmpOutOfPatch value
  Float_t fnxnAmpOutOfPatchThres; 
  Float_t fIs2x2Isol;             //  Patch is isolated if f2x2AmpOutOfPatchThres threshold is passed
  Float_t fIsnxnIsol ; 

  Bool_t  fSimulation ;           //! Flag to do the trigger during simulation or reconstruction
  Bool_t  fIsolateInSuperModule;  //! Flag to isolate trigger patch in SuperModule or in TRU acceptance

  ClassDef(AliEMCALTrigger,1)
} ;
    
    
#endif //ALIEMCALTrigger_H
Commit	Line	Data
	1	#ifndef ALIEMCALTrigger_H
	2	#define ALIEMCALTrigger_H
	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	// Class for trigger analysis.
	10	//
	11	// -- Author: Gustavo Conesa & Yves Schutz (IFIC, SUBATECH, CERN)
	12	// Digits are grouped in TRU's (Trigger Units). A TRU consist of 384 cells
	13	// ordered fNTRUPhi x fNTRUEta matrix. The algorithm searches all possible
	14	// 2x2 and nxn (n multiple of 4) crystal combinations per each TRU, adding the
	15	// digits amplitude and finding the maximum. It is found is maximum is isolated.
	16	// Maxima are transformed in adc time samples. Each time bin is compared to the
	17	// trigger threshold until it is larger and then, triggers are set.
	18	// Thresholds need to be fixed.
	19	// Last 2 modules are half size in Phi, I considered that the number
	20	// of TRU is maintained for the last modules but final decision has not
	21	// been taken. If different, then this must to be changed.
	22	// Usage:
	23	//
	24	// //Inside the event loop
	25	// AliEMCALTrigger *tr = new AliEMCALTrigger();//Init Trigger
	26	// tr->SetL0Threshold(100);
	27	// tr->SetL1JetLowPtThreshold(1000);
	28	// tr->SetL1JetMediumPtThreshold(10000);
	29	// tr->SetL1JetHighPtThreshold(20000);
	30	// ....
	31	// tr->Trigger(); //Execute Trigger
	32	// tr->Print(""); //Print data members after calculation.
	33	//
	34	//*-- Author: Gustavo Conesa & Yves Schutz (IFIC, SUBATECH, CERN)
	35
	36	// --- ROOT system ---
	37
	38	class TClonesArray ;
	39	#include "TMatrixD.h"
	40
	41	// --- AliRoot header files ---
	42	#include "AliTriggerDetector.h"
	43
	44	class AliEMCALGeometry ;
	45
	46	class AliEMCALTrigger : public AliTriggerDetector {
	47
	48	public:
	49
	50	AliEMCALTrigger() ; // ctor
	51	AliEMCALTrigger(const AliEMCALTrigger & trig) ; // cpy ctor
	52	virtual ~AliEMCALTrigger(); //virtual dtor
	53
	54
	55	virtual void CreateInputs(); //Define trigger inputs for Central Trigger Processor
	56	void Print(const Option_t * opt ="") const ;
	57	virtual void Trigger(); //Make EMCAL trigger
	58
	59	//assignment operator for coding convention
	60	const AliEMCALTrigger & operator = (const AliEMCALTrigger & ) {return *this;}
	61
	62	//Getters
	63	Float_t Get2x2MaxAmplitude() const { return f2x2MaxAmp ; }
	64	Float_t GetnxnMaxAmplitude() const { return fnxnMaxAmp ; }
	65	Int_t Get2x2CellPhi() const { return f2x2CellPhi ; }
	66	Int_t GetnxnCellPhi() const { return fnxnCellPhi ; }
	67	Int_t Get2x2CellEta() const { return f2x2CellEta ; }
	68	Int_t GetnxnCellEta() const { return fnxnCellEta ; }
	69	Int_t Get2x2SuperModule() const { return f2x2SM ; }
	70	Int_t GetnxnSuperModule() const { return fnxnSM ; }
	71
	72	Int_t * GetADCValuesLowGainMax2x2Sum() { return fADCValuesLow2x2; }
	73	Int_t * GetADCValuesHighGainMax2x2Sum() { return fADCValuesHigh2x2; }
	74	Int_t * GetADCValuesLowGainMaxnxnSum() { return fADCValuesLownxn; }
	75	Int_t * GetADCValuesHighGainMaxnxnSum() { return fADCValuesHighnxn; }
	76
	77	Float_t GetL0Threshold() const { return fL0Threshold ; }
	78	Float_t GetL1JetLowPtThreshold() const { return fL1JetLowPtThreshold ; }
	79	Float_t GetL1JetMediumPtThreshold() const { return fL1JetMediumPtThreshold ; }
	80	Float_t GetL1JetHighPtThreshold() const { return fL1JetHighPtThreshold ; }
	81
	82	Int_t GetPatchSize() const { return fPatchSize ; }
	83	Int_t GetIsolPatchSize() const { return fIsolPatchSize ; }
	84
	85	Float_t Get2x2AmpOutOfPatch() const { return f2x2AmpOutOfPatch ; }
	86	Float_t GetnxnAmpOutOfPatch() const { return fnxnAmpOutOfPatch ; }
	87	Float_t Get2x2AmpOutOfPatchThres() const { return f2x2AmpOutOfPatchThres ; }
	88	Float_t GetnxnAmpOutOfPatchThres() const { return fnxnAmpOutOfPatchThres ; }
	89
	90	Bool_t Is2x2Isol() const { return fIs2x2Isol ; }
	91	Bool_t IsnxnIsol() const { return fIsnxnIsol ; }
	92
	93	Bool_t IsSimulation() const { return fSimulation ; }
	94	Bool_t IsIsolatedInSuperModule() const { return fIsolateInSuperModule ; }
	95
	96	//Setters
	97	void SetDigitsList(TClonesArray * digits)
	98	{fDigitsList = digits ; }
	99
	100	void SetL0Threshold(Int_t amp)
	101	{fL0Threshold = amp; }
	102	void SetL1JetLowPtThreshold(Int_t amp)
	103	{fL1JetLowPtThreshold = amp; }
	104	void SetL1JetMediumPtThreshold(Int_t amp)
	105	{fL1JetMediumPtThreshold = amp; }
	106	void SetL1JetHighPtThreshold(Int_t amp)
	107	{fL1JetHighPtThreshold = amp; }
	108
	109	void SetPatchSize(Int_t ps) {fPatchSize = ps ; }
	110	void SetIsolPatchSize(Int_t ps) {fIsolPatchSize = ps ; }
	111	void Set2x2AmpOutOfPatchThres(Float_t th) { f2x2AmpOutOfPatchThres = th; }
	112	void SetnxnAmpOutOfPatchThres(Float_t th) { fnxnAmpOutOfPatchThres = th; }
	113	void SetSimulation(Bool_t sim ) {fSimulation = sim ; }
	114	void SetIsolateInSuperModule(Bool_t isol ) {fIsolateInSuperModule = isol ; }
	115
	116	private:
	117
	118	void FillTRU(const AliEMCALGeometry geom, const TClonesArray digits, TClonesArray * ampmatrix, TClonesArray * ampmatrixsmod, TClonesArray * timeRmatrix);
	119
	120	Bool_t IsPatchIsolated(Int_t iPatchType, const TClonesArray * ampmods, const Int_t imod, const Int_t mtru, const Float_t maxamp, const Int_t maxphi, const Int_t maxeta) ;
	121
	122	void MakeSlidingCell(const TClonesArray * amptrus, const TClonesArray * timeRtrus,const Int_t supermod, TMatrixD &ampmax2, TMatrixD &ampmaxn) ;
	123
	124	void SetTriggers(const TClonesArray * amptrus,const Int_t iSM, const TMatrixD &ampmax2, const TMatrixD &ampmaxn, const AliEMCALGeometry * geom) ;
	125
	126
	127	private:
	128
	129	Float_t f2x2MaxAmp ; //! Maximum 2x2 added amplitude (not overlapped)
	130	Int_t f2x2CellPhi ; //! upper right cell, row(phi)
	131	Int_t f2x2CellEta ; //! and column(eta)
	132	Int_t f2x2SM ; //! Super Module where maximum is found
	133	Float_t fnxnMaxAmp ; //! Maximum nxn added amplitude (overlapped)
	134	Int_t fnxnCellPhi ; //! upper right cell, row(phi)
	135	Int_t fnxnCellEta ; //! and column(eta)
	136	Int_t fnxnSM ; //! Super Module where maximum is found
	137
	138	Int_t* fADCValuesHighnxn ; //! Sampled ADC high gain values for the nxn crystals amplitude sum
	139	Int_t* fADCValuesLownxn ; //! " low gain "
	140	Int_t* fADCValuesHigh2x2 ; //! " high gain " 2x2 "
	141	Int_t* fADCValuesLow2x2 ; //! " low gaing " "
	142
	143	TClonesArray* fDigitsList ; //Array of digits
	144
	145	Float_t fL0Threshold ; //! L0 trigger energy threshold
	146	Float_t fL1JetLowPtThreshold ; //! L1 Low pT trigger energy threshold
	147	Float_t fL1JetMediumPtThreshold ; //! L1 Medium pT trigger energy threshold
	148	Float_t fL1JetHighPtThreshold ; //! L1 High pT trigger energy threshold
	149
	150	Int_t fNTRU; //! Number of TRU per SuperModule (3)
	151	Int_t fNTRUEta ; //! Number of crystal rows per Eta in one TRU (3)
	152	Int_t fNTRUPhi ; //! Number of crystal rows per Phi in one TRU (1)
	153	Int_t fNCellsPhi; //! Number of rows in a TRU (24)
	154	Int_t fNCellsEta; //! Number of columns in a TRU (16)
	155
	156	Int_t fPatchSize; //! Trigger patch factor, to be multiplied to 2x2 cells
	157	// 0 means 2x2, 1 means 4x4, 2 means 6x6 ...
	158	Int_t fIsolPatchSize ; // Isolation patch size, number of rows or columns to add to
	159	// the 2x2 or nxn maximum amplitude patch.
	160	// 1 means a patch around max amplitude of 2x2 of 4x4 and around
	161	// max ampl patch of 4x4 of 8x8
	162
	163	Float_t f2x2AmpOutOfPatch; // Amplitude in isolation cone minus maximum amplitude of the reference patch
	164	Float_t fnxnAmpOutOfPatch;
	165	Float_t f2x2AmpOutOfPatchThres; // Threshold to select a trigger as isolated on f2x2AmpOutOfPatch value
	166	Float_t fnxnAmpOutOfPatchThres;
	167	Float_t fIs2x2Isol; // Patch is isolated if f2x2AmpOutOfPatchThres threshold is passed
	168	Float_t fIsnxnIsol ;
	169
	170	Bool_t fSimulation ; //! Flag to do the trigger during simulation or reconstruction
	171	Bool_t fIsolateInSuperModule; //! Flag to isolate trigger patch in SuperModule or in TRU acceptance
	172
	173	ClassDef(AliEMCALTrigger,1)
	174	} ;
	175
	176
	177	#endif //ALIEMCALTrigger_H
	178