[u/mrichter/AliRoot.git] / TOF / AliTOFSDigitizer.h

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


//_________________________________________________________________________
//  Task Class for making SDigits in TOF      
//                  
//-- Authors: F. Pierella, A. De Caro


#include "TTask.h"
#include "TString.h"
class AliRunLoader;
class AliLoader;

class AliTOFGeometry;
class TF1;

class AliTOFSDigitizer: public TTask {

public:
  AliTOFSDigitizer() ;          // ctor
  //AliTOFSDigitizer(const char* HeaderFile) ; // par ctor
  AliTOFSDigitizer(const char* HeaderFile, Int_t evNumber1=-1, Int_t nEvents=0) ; // par ctor

  AliTOFSDigitizer(const AliTOFSDigitizer &source); // copy constructor
  AliTOFSDigitizer& operator=(const AliTOFSDigitizer &source); // ass. op.

  virtual ~AliTOFSDigitizer() ; // dtor

  //static Float_t WidthTdcBin() {return fgkTdcBin;};

  virtual void  Exec(Option_t *verboseOption); 
  void SetSDigitsFile(char * /*file*/ ) {;}
  
  void InitParameters();
  virtual void PrintParameters() const ;
  virtual void SimulateDetectorResponse(Float_t z0, Float_t x0, Float_t geantTime, Int_t& nActivatedPads, Int_t& nFiredPads, Bool_t* isFired, Int_t* nPlace, Float_t* qInduced, Float_t* tofTime, Float_t& averageTime);
  virtual void Print(Option_t* opt) const ;
  void  SetFirstEvent(Int_t event1)      {fEvent1 = event1;}
  void  SetSecondEvent(Int_t event2)     {fEvent2 = event2;}
  Int_t GetFirstEvent()  const {return fEvent1;}
  Int_t GetSecondEvent() const {return fEvent2;}
  Int_t GetNEvents() const {return (fEvent2-fEvent1);}
  void  SelectSectorAndPlate(Int_t sector, Int_t plate);

  // setters and getters for detector simulation
  // it summarizes all it is known about TOF strip 
  void  SetPadefficiency(Float_t padefficiency)      {fpadefficiency=padefficiency;}
  void  SetEdgeEffect(Int_t   edgeEffect)            {fEdgeEffect=edgeEffect;}
  void  SetEdgeTails(Int_t   edgeTails)              {fEdgeTails=edgeTails;}
  void  SetHparameter(Float_t hparameter)            {fHparameter=hparameter;}
  void  SetH2parameter(Float_t h2parameter)          {fH2parameter=h2parameter;}
  void  SetKparameter(Float_t kparameter)            {fKparameter=kparameter;}
  void  SetK2parameter(Float_t k2parameter)          {fK2parameter=k2parameter;}
  void  SetEffCenter(Float_t effCenter)              {fEffCenter=effCenter;}
  void  SetEffBoundary(Float_t effBoundary)          {fEffBoundary=effBoundary;}
  void  SetEff2Boundary(Float_t eff2Boundary)        {fEff2Boundary=eff2Boundary;}
  void  SetEff3Boundary(Float_t eff3Boundary)        {fEff3Boundary=eff3Boundary;}
  void  SetAddTRes(Float_t addTRes)                  {fAddTRes=addTRes;}
  void  SetResCenter (Float_t resCenter)             {fResCenter=resCenter;}
  void  SetResBoundary(Float_t resBoundary)          {fResBoundary=resBoundary;}
  void  SetResSlope(Float_t resSlope)                {fResSlope=resSlope;}
  void  SetTimeWalkCenter(Float_t timeWalkCenter)    {fTimeWalkCenter=timeWalkCenter;}
  void  SetTimeWalkBoundary(Float_t timeWalkBoundary){fTimeWalkBoundary=timeWalkBoundary;}
  void  SetTimeWalkSlope(Float_t timeWalkSlope)      {fTimeWalkSlope=timeWalkSlope;}

  void  SetTimeDelayFlag(Int_t timeDelayFlag)        {fTimeDelayFlag=timeDelayFlag;}
  void  SetPulseHeightSlope(Float_t pulseHeightSlope){fPulseHeightSlope=pulseHeightSlope;}
  void  SetTimeDelaySlope(Float_t timeDelaySlope)    {fTimeDelaySlope=timeDelaySlope;}
  void  SetMinimumCharge(Float_t minimumCharge)      {fMinimumCharge=minimumCharge;}
  void  SetChargeSmearing(Float_t chargeSmearing)    {fChargeSmearing=chargeSmearing;}
  void  SetLogChargeSmearing(Float_t logChargeSmearing){fLogChargeSmearing=logChargeSmearing;}
  void  SetTimeSmearing(Float_t timeSmearing)        {fTimeSmearing=timeSmearing;}
  void  SetAverageTimeFlag(Int_t averageTimeFlag)    {fAverageTimeFlag=averageTimeFlag;}

  void  SetAdcBin(Float_t adcBin)                    {fAdcBin=adcBin;}
  void  SetAdcMean(Float_t adcMean)                  {fAdcMean=adcMean;}
  void  SetAdcRms(Float_t adcRms)                    {fAdcRms=adcRms;}

  Float_t  GetPadefficiency()    const {return fpadefficiency;}
  Int_t    GetEdgeEffect()       const {return fEdgeEffect;}
  Int_t    GetEdgeTails()        const {return fEdgeTails;}
  Float_t  GetHparameter()       const {return fHparameter;}
  Float_t  GetH2parameter()      const {return fH2parameter;}
  Float_t  GetKparameter()       const {return fKparameter;}
  Float_t  GetK2parameter()      const {return fK2parameter;}
  Float_t  GetEffCenter()        const {return fEffCenter;}
  Float_t  GetEffBoundary()      const {return fEffBoundary;}
  Float_t  GetEff2Boundary()     const {return fEff2Boundary;}
  Float_t  GetEff3Boundary()     const {return fEff3Boundary;}
  Float_t  GetAddTRes ()         const {return fAddTRes;}
  Float_t  GetResCenter ()       const {return fResCenter;}
  Float_t  GetResBoundary()      const {return fResBoundary;}
  Float_t  GetResSlope()         const {return fResSlope;}
  Float_t  GetTimeWalkCenter()   const {return fTimeWalkCenter;}
  Float_t  GetTimeWalkBoundary() const {return fTimeWalkBoundary;}
  Float_t  GetTimeWalkSlope()    const {return fTimeWalkSlope;}
  Int_t    GetTimeDelayFlag()    const {return fTimeDelayFlag;}
  Float_t  GetPulseHeightSlope() const {return fPulseHeightSlope;}
  Float_t  GetTimeDelaySlope()   const {return fTimeDelaySlope;}
  Float_t  GetMinimumCharge()    const {return fMinimumCharge;}
  Float_t  GetChargeSmearing()   const {return fChargeSmearing;}
  Float_t  GetLogChargeSmearing()const {return fLogChargeSmearing;}
  Float_t  GetTimeSmearing()     const {return fTimeSmearing;}
  Int_t    GetAverageTimeFlag()  const {return fAverageTimeFlag;}

  Float_t  GetAdcBin()           const {return fAdcBin;}
  Float_t  GetAdcMean()          const {return fAdcMean;}
  Float_t  GetAdcRms()           const {return fAdcRms;}
  

protected:


private:
  Int_t   fEvent1;          // lower bound for events to sdigitize
  Int_t   fEvent2;          // upper bound for events to sdigitize
  TF1     *ftail;           // pointer to formula for time with tail
  TString fHeadersFile;     // input file
  AliRunLoader* fRunLoader; //! Run Loader
  AliLoader* fTOFLoader;    //! Loader

  AliTOFGeometry* fTOFGeometry;  // Pointer to the TOF geometry

  Int_t fSelectedSector;    // sector number for sdigitization
  Int_t fSelectedPlate ;    // plate  number for sdigitization

  // detector response simulation
  // Intrisic MRPC time resolution and pad (edge effect) parameters
  Float_t fTimeResolution;  // time resolution of the MRPC (ns)
  Float_t fpadefficiency;   // intrinsic pad efficiency, used if fEdgeEffect==0
  Int_t   fEdgeEffect;      // edge effects option
  Int_t   fEdgeTails;       // edge tails option
  Float_t fHparameter;      // sensitive edge (to produce hits on the neighbouring pads)
                            //                 0.7 cm (old); 0.4 cm (new)
  Float_t fH2parameter;     // parameter to fit the efficiency
  Float_t fKparameter;      // sensitive edge (going ahead towards the center
                            // no delay effects are suffered) 1.0 cm (old); 0.5 cm (new)
  Float_t fK2parameter;     // parameter to fit the efficiency
  // Pad Efficiency and Resolution parameters
  Float_t fEffCenter;       // efficiency in the central region of the pad
  Float_t fEffBoundary;     // efficiency at the boundary of the pad
  Float_t fEff2Boundary;    // efficiency value at H2parameter
  Float_t fEff3Boundary;    // efficiency value at K2parameter
  Float_t fAddTRes;         // additional contribution to 
                            // the intrinsic MRPC time resolution (ps)
  Float_t fResCenter;       // resolution (ps) in the central region of the pad
  Float_t fResBoundary;     // resolution (ps)  at the boundary of the pad
  Float_t fResSlope;        // slope (ps/K) for neighbouring pad
  // Time Walk parameters
  Float_t fTimeWalkCenter;  // time walk (ps) in the central region of the pad
  Float_t fTimeWalkBoundary;// time walk (ps) at the boundary of the pad
  Float_t fTimeWalkSlope;   // slope (ps/K) for neighbouring pad
  Int_t   fTimeDelayFlag;   // flag for delay due to the PulseHeightEffect
  Float_t fPulseHeightSlope;// It determines the charge amount induced
  // due to edge effect, using the formula
  // qInduced=exp(-PulseHeightSlope*x)
  Float_t fTimeDelaySlope;  // It determines the time delay. This is the slope
  // in the T1-T2 vs log(q1/q2) plot
  // ADC-TDC correlation parameters
  Float_t fMinimumCharge;   // Minimum charge amount which could be induced
  Float_t fChargeSmearing;  // Smearing in charge in (q1/q2) vs x plot
  Float_t fLogChargeSmearing;// Smearing in log of charge ratio
  Float_t fTimeSmearing;    // Smearing in time in time vs log(q1/q2) plot
  Int_t   fAverageTimeFlag; // flag (see the setter for details)

  Float_t fAdcBin;      // charge-window for the ADC bins [pC]
  Float_t fAdcMean;     // mean value for the ADC spectrum [bins]
  Float_t fAdcRms;      // rms value for the ADC spectrum [bins]

  ClassDef(AliTOFSDigitizer,2)  // creates TOF SDigits

};

#endif // AliTOFSDigitizer_H
Commit	Line	Data
517b7f8f	1	#ifndef ALITOFSDigitizer_H
	2	#define ALITOFSDigitizer_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	// Task Class for making SDigits in TOF
	9	//
ea7a588a	10	//-- Authors: F. Pierella, A. De Caro
517b7f8f	11
	12
	13	#include "TTask.h"
	14	#include "TString.h"
88cb7938	15	class AliRunLoader;
d61f73d9	16	class AliLoader;
517b7f8f	17
d3c7bfac	18	class AliTOFGeometry;
f73548c4	19	class TF1;
f73548c4	20
517b7f8f	21	class AliTOFSDigitizer: public TTask {
	22
	23	public:
	24	AliTOFSDigitizer() ; // ctor
d61f73d9	25	//AliTOFSDigitizer(const char* HeaderFile) ; // par ctor
d61f73d9	26	AliTOFSDigitizer(const char* HeaderFile, Int_t evNumber1=-1, Int_t nEvents=0) ; // par ctor
517b7f8f	27
7aeeaf38	28	AliTOFSDigitizer(const AliTOFSDigitizer &source); // copy constructor
	29	AliTOFSDigitizer& operator=(const AliTOFSDigitizer &source); // ass. op.
	30
517b7f8f	31	virtual ~AliTOFSDigitizer() ; // dtor
bfec09a6	32
43f77f2d	33	//static Float_t WidthTdcBin() {return fgkTdcBin;};
43f77f2d	34
d61f73d9	35	virtual void Exec(Option_t *verboseOption);
cfa58405	36	void SetSDigitsFile(char * /file/ ) {;}
3408aff3	37
f73548c4	38	void InitParameters();
f73548c4	39	virtual void PrintParameters() const ;
d61f73d9	40	virtual void SimulateDetectorResponse(Float_t z0, Float_t x0, Float_t geantTime, Int_t& nActivatedPads, Int_t& nFiredPads, Bool_t* isFired, Int_t* nPlace, Float_t* qInduced, Float_t* tofTime, Float_t& averageTime);
ea7a588a	41	virtual void Print(Option_t* opt) const ;
d61f73d9	42	void SetFirstEvent(Int_t event1) {fEvent1 = event1;}
d61f73d9	43	void SetSecondEvent(Int_t event2) {fEvent2 = event2;}
ea7a588a	44	Int_t GetFirstEvent() const {return fEvent1;}
	45	Int_t GetSecondEvent() const {return fEvent2;}
	46	Int_t GetNEvents() const {return (fEvent2-fEvent1);}
55991c8b	47	void SelectSectorAndPlate(Int_t sector, Int_t plate);
517b7f8f	48
f73548c4	49	// setters and getters for detector simulation
	50	// it summarizes all it is known about TOF strip
	51	void SetPadefficiency(Float_t padefficiency) {fpadefficiency=padefficiency;}
	52	void SetEdgeEffect(Int_t edgeEffect) {fEdgeEffect=edgeEffect;}
	53	void SetEdgeTails(Int_t edgeTails) {fEdgeTails=edgeTails;}
	54	void SetHparameter(Float_t hparameter) {fHparameter=hparameter;}
	55	void SetH2parameter(Float_t h2parameter) {fH2parameter=h2parameter;}
	56	void SetKparameter(Float_t kparameter) {fKparameter=kparameter;}
	57	void SetK2parameter(Float_t k2parameter) {fK2parameter=k2parameter;}
	58	void SetEffCenter(Float_t effCenter) {fEffCenter=effCenter;}
	59	void SetEffBoundary(Float_t effBoundary) {fEffBoundary=effBoundary;}
	60	void SetEff2Boundary(Float_t eff2Boundary) {fEff2Boundary=eff2Boundary;}
	61	void SetEff3Boundary(Float_t eff3Boundary) {fEff3Boundary=eff3Boundary;}
7e6dce66	62	void SetAddTRes(Float_t addTRes) {fAddTRes=addTRes;}
f73548c4	63	void SetResCenter (Float_t resCenter) {fResCenter=resCenter;}
	64	void SetResBoundary(Float_t resBoundary) {fResBoundary=resBoundary;}
	65	void SetResSlope(Float_t resSlope) {fResSlope=resSlope;}
	66	void SetTimeWalkCenter(Float_t timeWalkCenter) {fTimeWalkCenter=timeWalkCenter;}
	67	void SetTimeWalkBoundary(Float_t timeWalkBoundary){fTimeWalkBoundary=timeWalkBoundary;}
	68	void SetTimeWalkSlope(Float_t timeWalkSlope) {fTimeWalkSlope=timeWalkSlope;}
	69
	70	void SetTimeDelayFlag(Int_t timeDelayFlag) {fTimeDelayFlag=timeDelayFlag;}
	71	void SetPulseHeightSlope(Float_t pulseHeightSlope){fPulseHeightSlope=pulseHeightSlope;}
	72	void SetTimeDelaySlope(Float_t timeDelaySlope) {fTimeDelaySlope=timeDelaySlope;}
	73	void SetMinimumCharge(Float_t minimumCharge) {fMinimumCharge=minimumCharge;}
	74	void SetChargeSmearing(Float_t chargeSmearing) {fChargeSmearing=chargeSmearing;}
	75	void SetLogChargeSmearing(Float_t logChargeSmearing){fLogChargeSmearing=logChargeSmearing;}
	76	void SetTimeSmearing(Float_t timeSmearing) {fTimeSmearing=timeSmearing;}
	77	void SetAverageTimeFlag(Int_t averageTimeFlag) {fAverageTimeFlag=averageTimeFlag;}
43f77f2d	78
ea7a588a	79	void SetAdcBin(Float_t adcBin) {fAdcBin=adcBin;}
	80	void SetAdcMean(Float_t adcMean) {fAdcMean=adcMean;}
	81	void SetAdcRms(Float_t adcRms) {fAdcRms=adcRms;}
f73548c4	82
	83	Float_t GetPadefficiency() const {return fpadefficiency;}
	84	Int_t GetEdgeEffect() const {return fEdgeEffect;}
	85	Int_t GetEdgeTails() const {return fEdgeTails;}
	86	Float_t GetHparameter() const {return fHparameter;}
	87	Float_t GetH2parameter() const {return fH2parameter;}
	88	Float_t GetKparameter() const {return fKparameter;}
	89	Float_t GetK2parameter() const {return fK2parameter;}
	90	Float_t GetEffCenter() const {return fEffCenter;}
	91	Float_t GetEffBoundary() const {return fEffBoundary;}
	92	Float_t GetEff2Boundary() const {return fEff2Boundary;}
	93	Float_t GetEff3Boundary() const {return fEff3Boundary;}
7e6dce66	94	Float_t GetAddTRes () const {return fAddTRes;}
f73548c4	95	Float_t GetResCenter () const {return fResCenter;}
	96	Float_t GetResBoundary() const {return fResBoundary;}
	97	Float_t GetResSlope() const {return fResSlope;}
	98	Float_t GetTimeWalkCenter() const {return fTimeWalkCenter;}
	99	Float_t GetTimeWalkBoundary() const {return fTimeWalkBoundary;}
	100	Float_t GetTimeWalkSlope() const {return fTimeWalkSlope;}
	101	Int_t GetTimeDelayFlag() const {return fTimeDelayFlag;}
	102	Float_t GetPulseHeightSlope() const {return fPulseHeightSlope;}
	103	Float_t GetTimeDelaySlope() const {return fTimeDelaySlope;}
	104	Float_t GetMinimumCharge() const {return fMinimumCharge;}
	105	Float_t GetChargeSmearing() const {return fChargeSmearing;}
	106	Float_t GetLogChargeSmearing()const {return fLogChargeSmearing;}
	107	Float_t GetTimeSmearing() const {return fTimeSmearing;}
	108	Int_t GetAverageTimeFlag() const {return fAverageTimeFlag;}
43f77f2d	109
ea7a588a	110	Float_t GetAdcBin() const {return fAdcBin;}
	111	Float_t GetAdcMean() const {return fAdcMean;}
	112	Float_t GetAdcRms() const {return fAdcRms;}
f73548c4	113
517b7f8f	114
7e6dce66	115	protected:
	116
	117
517b7f8f	118	private:
ea7a588a	119	Int_t fEvent1; // lower bound for events to sdigitize
ea7a588a	120	Int_t fEvent2; // upper bound for events to sdigitize
f73548c4	121	TF1 *ftail; // pointer to formula for time with tail
5919c40c	122	TString fHeadersFile; // input file
d61f73d9	123	AliRunLoader* fRunLoader; //! Run Loader
d61f73d9	124	AliLoader* fTOFLoader; //! Loader
d3c7bfac	125
7aeeaf38	126	AliTOFGeometry* fTOFGeometry; // Pointer to the TOF geometry
88cb7938	127
55991c8b	128	Int_t fSelectedSector; // sector number for sdigitization
55991c8b	129	Int_t fSelectedPlate ; // plate number for sdigitization
517b7f8f	130
f73548c4	131	// detector response simulation
	132	// Intrisic MRPC time resolution and pad (edge effect) parameters
	133	Float_t fTimeResolution; // time resolution of the MRPC (ns)
	134	Float_t fpadefficiency; // intrinsic pad efficiency, used if fEdgeEffect==0
	135	Int_t fEdgeEffect; // edge effects option
	136	Int_t fEdgeTails; // edge tails option
d61f73d9	137	Float_t fHparameter; // sensitive edge (to produce hits on the neighbouring pads)
d61f73d9	138	// 0.7 cm (old); 0.4 cm (new)
f73548c4	139	Float_t fH2parameter; // parameter to fit the efficiency
d61f73d9	140	Float_t fKparameter; // sensitive edge (going ahead towards the center
d61f73d9	141	// no delay effects are suffered) 1.0 cm (old); 0.5 cm (new)
f73548c4	142	Float_t fK2parameter; // parameter to fit the efficiency
	143	// Pad Efficiency and Resolution parameters
	144	Float_t fEffCenter; // efficiency in the central region of the pad
	145	Float_t fEffBoundary; // efficiency at the boundary of the pad
	146	Float_t fEff2Boundary; // efficiency value at H2parameter
	147	Float_t fEff3Boundary; // efficiency value at K2parameter
7e6dce66	148	Float_t fAddTRes; // additional contribution to
7e6dce66	149	// the intrinsic MRPC time resolution (ps)
f73548c4	150	Float_t fResCenter; // resolution (ps) in the central region of the pad
	151	Float_t fResBoundary; // resolution (ps) at the boundary of the pad
	152	Float_t fResSlope; // slope (ps/K) for neighbouring pad
	153	// Time Walk parameters
	154	Float_t fTimeWalkCenter; // time walk (ps) in the central region of the pad
	155	Float_t fTimeWalkBoundary;// time walk (ps) at the boundary of the pad
	156	Float_t fTimeWalkSlope; // slope (ps/K) for neighbouring pad
	157	Int_t fTimeDelayFlag; // flag for delay due to the PulseHeightEffect
	158	Float_t fPulseHeightSlope;// It determines the charge amount induced
	159	// due to edge effect, using the formula
	160	// qInduced=exp(-PulseHeightSlope*x)
	161	Float_t fTimeDelaySlope; // It determines the time delay. This is the slope
	162	// in the T1-T2 vs log(q1/q2) plot
	163	// ADC-TDC correlation parameters
	164	Float_t fMinimumCharge; // Minimum charge amount which could be induced
	165	Float_t fChargeSmearing; // Smearing in charge in (q1/q2) vs x plot
	166	Float_t fLogChargeSmearing;// Smearing in log of charge ratio
	167	Float_t fTimeSmearing; // Smearing in time in time vs log(q1/q2) plot
	168	Int_t fAverageTimeFlag; // flag (see the setter for details)
43f77f2d	169
ea7a588a	170	Float_t fAdcBin; // charge-window for the ADC bins [pC]
	171	Float_t fAdcMean; // mean value for the ADC spectrum [bins]
	172	Float_t fAdcRms; // rms value for the ADC spectrum [bins]
f73548c4	173
55991c8b	174	ClassDef(AliTOFSDigitizer,2) // creates TOF SDigits
517b7f8f	175
	176	};
	177
	178	#endif // AliTOFSDigitizer_H