Tuned layer 1-3 module thickness to have overall 0.3% x/x0 per layer

[u/mrichter/AliRoot.git] / ITS / UPGRADE / AliITSUSimulationPix.h

#ifndef ALIITSUSIMULATIONPIX_H
#define ALIITSUSIMULATIONPIX_H

/* Copyright(c) 2007-2009, ALICE Experiment at CERN, All rights reserved. *
* See cxx source for full Copyright notice                               */

////////////////////////////////////////////////////////////
// Simulation class for upgrade pixels                    //
////////////////////////////////////////////////////////////

#include <TObjArray.h>
#include "AliITSUSimulation.h"
#include "AliITSUSegmentationPix.h"

class TH1F;
class AliITSUModule;
class AliITSUSimuParam;
class AliITSUParamList;
class TH2;

//-------------------------------------------------------------------

class AliITSUSimulationPix : public AliITSUSimulation {
public:
  enum {kCellX1,kCellX2,kCellZ1,kCellZ2,kCellYDepth,kNDtSpread}; // data used for ch. spread integral calc.
  //
  // charge spread functions defined
  enum {kSpreadFunGauss2D                   // single gaussian in 2D, SpreadFunGauss2D
	,kSpreadFunDoubleGauss2D            // double gaussian in 2D, SpreadFunDoubleGauss2D
	,kSpreadFunHisto                    // use 2D histo from the object stored in fResponseParam
	,kNSpreadFuns
  };
  // These are enums for interpretation of the entries in the AliITSUParamList*fResponseParam : 
  // object to holding the sensor-specific response data 
  // fist kParamStart entries of spread fun params are reserved for common parameters
  enum {kChargeSpreadType                  // charge spread function type, one of kNSpreadFuns types
	,kSpreadFunParamNXoffs               // number of pixels to consider +- from injection point (in X)
	,kSpreadFunParamNZoffs               // number of pixels to consider +- from injection point (in Z)
	,kSpreadFunMinSteps                  // the single hit charge is divided into kSpreadFunMinSteps (minimum is 3)
        ,kReadOutSchemeType                  // readout type strobe, rolling shutter etc
	,kReadOutCycleLength                 // full readout cycle window
        ,kSpreadFunGlobalQScale              // Global charge scaling factor to match tes beam results to simu (Geant3)
        ,kPixSNDisrcCut                      // S/N cut applied at discrimination level
        ,kPixMinElToAdd                      // Min number of electrons to add to sdig
        ,kPixNoiseIsOn                       // Turn Pixel Noise on
        ,kPixNoiseInAllMod                   // To apply pixel noise in all modules, if not only on ones where there is a hit
	,kPixNoiseMPV                        // Pixel noise MPV
        ,kPixNoiseSigma                      // Pixel noise sigma
        ,kPixFakeRate                        // Pixel fake rate	
	// 
	,kNReservedParams=20                 // some reserved slots
	,kParamStart = kNReservedParams       // user parameters must start from this slot
  };
  //
  // defined readout types:
  enum {kReadOutStrobe                      // hits in static time window fReadOutCycleLength wrt offset fReadOOutCycleOffset (global for sensor) are seen
	,kReadOutRollingShutter             // hits in rolling (row-wise) window are seen (see GetReadOutCycleRollingShutter)
	,kNReadOutTypes
  }; 
  // elements of the SpreadFunGauss2D parameterization (offsetted by kParamStart)
  enum {kG1MeanX=kParamStart,kG1SigX,kG1MeanZ,kG1SigZ,kNG1Par};
  // elements of the SpreadFunDoubleGauss2D parameterization (offsetted by kParamStart)
  enum {kG2MeanX0=kParamStart,kG2SigX0,kG2MeanZ0,kG2SigZ0,kG2MeanX1,kG2SigX1,kG2MeanZ1,kG2SigZ1,kG2ScaleG2,kNG2Par};
  //
  AliITSUSimulationPix();
  AliITSUSimulationPix(AliITSUSimuParam* sim,AliITSUSensMap* map);
  virtual ~AliITSUSimulationPix();
  AliITSUSimulationPix(const AliITSUSimulationPix &source); 
  AliITSUSimulationPix& operator=(const AliITSUSimulationPix &s);
  void Init();
  //
  void FinishSDigitiseModule();
  void DigitiseModule();
  //
  void SDigitiseModule();
  void WriteSDigits();
  void Hits2SDigits();
  void Hits2SDigitsFast();
  void AddNoisyPixels();   
  void RemoveDeadPixels();
  void FrompListToDigits();
  //
  Int_t AddRandomNoisePixels(Double_t tof=0);
  Bool_t SetTanLorAngle(Double_t WeightHole=1.0);
  Double_t GetTanLorAngle() const {return fTanLorAng;};
  //
  // For backwards compatibility
  void SDigitsToDigits(){ FinishSDigitiseModule();}
  //  
  Double_t SpreadFunDoubleGauss2D(const Double_t *dtIn);
  Double_t SpreadFunGauss2D(const Double_t *dtIn);
  Double_t SpreadFrom2DHisto(const Double_t *dtIn);
  //
  virtual void SetResponseParam(AliITSUParamList* resp);
  //
  Int_t GetReadOutCycle(Int_t row, Int_t col, Double_t hitTime);
  Int_t GetReadOutCycleRollingShutter(Int_t row, Int_t col, Double_t hitTime);
  //
  void CalcDiodeShiftInPixel(Int_t xrow, Int_t zcol, Float_t &x, Float_t &z);
  //
 private:
  void SpreadCharge2D(Double_t x0,Double_t z0, Double_t dy, Int_t ix0,Int_t iz0,
		      Double_t el, Double_t tof, Int_t tID, Int_t hID);
  //
  void SetCoupling(AliITSUSDigit* old);     // "New" coupling routine  Tiziano Virgili
  void SetCouplingOld(AliITSUSDigit* old);  // "Old" coupling routine  Rocco Caliandro
  //   
 protected:
   Double_t      fTanLorAng;               //! Tangent of the Lorentz Angle (weighted average for hole and electrons)
   Double_t      fGlobalChargeScale;       // Charge scaling to match Geant and Test beam
   //   
   TH2*          fSpread2DHisto;           //! optional 2D histo for charge spread parameterization
   Double_t (AliITSUSimulationPix::*fSpreadFun)(const Double_t *dtIn); //! pointer on current spread function
   Int_t    (AliITSUSimulationPix::*fROTimeFun)(Int_t row,Int_t col, Double_t hitTime); //! pointer on current R/O time check function

   ClassDef(AliITSUSimulationPix,1)  // Simulation of pixel clusters
 };
#endif