ITS/AliITS.h

   1 #ifndef ALIITS_H
   2 #define ALIITS_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 //           Manager class for set: ITS                               //
  10 ////////////////////////////////////////////////////////////////////////
  11
  12 #include <TObjArray.h> // used in inline function GetModule.
  13 #include <TBranch.h>   // used in inline function SetHitsAddressBranch
  14
  15 #include "AliRun.h"
  16 #include "AliDetector.h"
  17
  18 class TString;
  19 class TTree;
  20 class TFile;
  21
  22 class AliITSDetType;
  23 class AliITSsimulation;
  24 class AliITSClusterFinder;
  25 class AliITSsegmentation;
  26 class AliITSresponse;
  27 class AliITShit;
  28 class AliITSgeom;
  29 class AliITSpListItem;
  30 class AliITSdigit;
  31 class AliITSRecPoint;
  32 class AliITSRawCluster;
  33 class AliITSmodule;
  34
  35 const Int_t kNTYPES=3;
  36
  37 class AliITS : public AliDetector {
  38
  39  public:
  40     //================= Standard Classes ===============================
  41     AliITS();  // Default creator.
  42     AliITS(const char *name, const char *title); // standard Creator
  43     virtual ~AliITS(); // destructor
  44     AliITS(AliITS &source); // copy constructor. Not to be used!
  45     AliITS& operator=(AliITS &source); // = operator. Not to be used!
  46     virtual Int_t IsVersion() const {return 1;}
  47     virtual Int_t DistancetoPrimitive(Int_t px, Int_t py);
  48
  49     //===================== Simulation Geometry ========================
  50     // get geometry version - detailed (major) or coarse (minor)
  51     virtual Int_t GetMajorVersion(){return -1;}
  52     virtual Int_t GetMinorVersion(){return -1;}
  53     virtual void  GetGeometryVersion(Int_t &a,Int_t &b)
  54                            {a = GetMajorVersion();b=GetMinorVersion();return;}
  55     virtual void  SetEUCLID(Bool_t euclid=1) {fEuclidOut = euclid;}
  56     //-------------------- Geometry Transformations --------------------
  57     // ITS geometry functions
  58     AliITSgeom   *GetITSgeom() const {return fITSgeom;}
  59     // Sets ITS geometry ! be very careful using this function.
  60     void   SetITSgeom(AliITSgeom *geom) {fITSgeom = geom;}
  61     // return pointer to the array of modules
  62     TObjArray    *GetModules() const {return fITSmodules;}
  63     // return pointer to a particular module
  64     AliITSmodule *GetModule(Int_t index) {return (AliITSmodule *)
  65                                               (fITSmodules->At(index));}
  66
  67     //================ Nessesary general Classes =======================
  68     virtual void Init();
  69     virtual void SetDefaults();
  70     virtual void SetDefaultSimulation();
  71     virtual void SetDefaultClusterFinders();
  72     virtual void MakeBranch(Option_t *opt=" ", const char *file=0);
  73     virtual void SetTreeAddress();
  74     // For a give branch from the treeH sets the TClonesArray address.
  75     virtual void SetHitsAddressBranch(TBranch *b){b->SetAddress(&fHits);}
  76     // Return pointer to DetType #id
  77     AliITSDetType *DetType(Int_t id);
  78     //Int_t           NDetTypes() {return fNDetTypes;}
  79     //---------- Configuration Methods (per detector type) -------------
  80     // Determines which ITS subdetectors will be processed. Effects
  81     // digitization, and Reconstruction only.
  82     void SetDetectors(Option_t *opt="All"){fOpt = opt;}
  83     // Returns the list of ITS subdetectors that will be processed.
  84     Option_t* GetDetectors(){return fOpt;}
  85     // Set response
  86     virtual void SetResponseModel(Int_t id, AliITSresponse *response);
  87     // Set segmentation
  88     virtual void SetSegmentationModel(Int_t id, AliITSsegmentation *seg);
  89     // Set simulation - temporary
  90     virtual void SetSimulationModel(Int_t id, AliITSsimulation *sim);
  91     // Set reconstruction
  92     virtual void SetReconstructionModel(Int_t id, AliITSClusterFinder *rec);
  93     // Set class names for digit and rec point
  94     virtual void SetClasses(Int_t id, const char *digit, const char *cluster);
  95
  96     //=================== Hits =========================================
  97     virtual void StepManager() {} // See Step Manager for specific geometry.
  98     virtual void AddHit(Int_t track, Int_t *vol, Float_t *hits);
  99     //------------ sort hits by module for Digitisation ----------------
 100     virtual void InitModules(Int_t size,Int_t &nmodules);
 101     virtual void FillModules(Int_t evnt,Int_t bgrev,Int_t nmodules,
 102                              Option_t *opt,Text_t *filename);
 103     virtual void ClearModules();
 104
 105     //===================== Digitisation ===============================
 106     void MakeBranchS(const char *file);
 107     void SetTreeAddressS(TTree *treeS);
 108     TClonesArray * GetSDigits() { return fSDigits; }
 109     void MakeBranchInTreeD(TTree *treeD,const char *file=0);
 110     void MakeBranchD(const char *file){
 111         MakeBranchInTreeD(gAlice->TreeD(),file);}
 112     void SetTreeAddressD(TTree *treeD);
 113     void Hits2SDigits(); // Turn hits into SDigits
 114     void Hits2PreDigits(); // Turn hits into SDigits
 115     void SDigits2Digits(); // Turn SDigits to Digits
 116     void Hits2Digits(); // Turn hits straight into Digits.
 117     //------------------ Internal functions ----------------------------
 118     // Standard Hits To SDigits function
 119     void HitsToSDigits(Int_t evNumber,Int_t bgrev,Int_t size,
 120                  Option_t *add, Option_t *det, Text_t *filename);
 121     // Standard Hits To SDigits function
 122     void HitsToPreDigits(Int_t evNumber,Int_t bgrev,Int_t size,
 123                  Option_t *add, Option_t *det, Text_t *filename);
 124     // Standard Hits To Digits function
 125     void HitsToDigits(Int_t evNumber,Int_t bgrev,Int_t size,
 126                  Option_t *add, Option_t *det, Text_t *filename);
 127     void ResetSDigits();                  // Resets the Summable digits.
 128     void ResetDigits();                   // depending on how the
 129     void ResetDigits(Int_t branch);       // tree will be filled only
 130     void AddSumDigit(AliITSpListItem &sdig);
 131     void AddRealDigit(Int_t branch, Int_t *digits);
 132     void AddSimDigit(Int_t branch, AliITSdigit *d);
 133     void AddSimDigit(Int_t branch,Float_t phys,Int_t* digits,
 134                      Int_t* tracks,Int_t *hits,Float_t* trkcharges);
 135     // Return pointers to digits
 136     TObjArray    *Dtype() {return fDtype;}
 137     Int_t        *Ndtype() {return fNdtype;}
 138     TClonesArray *DigitsAddress(Int_t id)
 139         {return ((TClonesArray *) (*fDtype)[id]);}
 140
 141     //===================== Raw Data IO ================================
 142     // Write digits into raw data format
 143     virtual void Digits2RawData() {}
 144     // Decode raw data and store digits
 145     virtual void RawData2Digits() {}
 146
 147     //==================== Clusterization ==============================
 148     // create separate tree for clusters - declustering refining
 149     void MakeTreeC(Option_t *option="C");
 150     void GetTreeC(Int_t event);
 151     void AddCluster(Int_t branch, AliITSRawCluster *c);
 152     void ResetClusters();                 // one of the methods in
 153     void ResetClusters(Int_t branch);     // the pair will be kept
 154     // Return pointer to the tree of clusters
 155     TTree        *TreeC() {return fTreeC;}
 156     // Return pointers to clusters
 157     TObjArray    *Ctype() {return fCtype;}
 158     Int_t        *Nctype() {return fNctype;}
 159     TClonesArray *ClustersAddress(Int_t id)
 160                    {return ((TClonesArray *) (*fCtype)[id]);}
 161
 162     //=================== Reconstruction ===============================
 163     void MakeBranchR(const char *file);
 164     void SetTreeAddressR(TTree *treeR);
 165     void AddRecPoint(const AliITSRecPoint &p);
 166     void HitsToFastRecPoints(Int_t evNumber,Int_t bgrev,Int_t size,
 167                  Option_t *add, Option_t *det, Text_t *filename);
 168     void Digits2Reco();
 169     void DigitsToRecPoints(Int_t evNumber,Int_t lastEntry,Option_t *det);
 170     void ResetRecPoints();
 171     // Return pointer to rec points
 172     TClonesArray  *RecPoints()   {return fRecPoints;}
 173
 174  protected:
 175     //================== Data Members ==================================
 176     AliITSgeom   *fITSgeom;    // Pointer to ITS geometry
 177     Bool_t       fEuclidOut;   // Flag to write geometry in euclid format
 178     TObjArray    *fITSmodules; //! Pointer to ITS modules
 179     Option_t     *fOpt;        //! Detector option ="All" unless changed.
 180
 181     Int_t        fIdN;         // the number of layers
 182     Int_t        *fIdSens;     //[fIdN] layer identifier
 183     TString      *fIdName;     //[fIdN] layer identifier
 184
 185     Int_t        fNDetTypes;   // Number of detector types
 186     TObjArray    *fDetTypes;   // List of detector types
 187
 188     TClonesArray    *fSDigits;    // List of Summable digits.
 189     Int_t         fNSDigits;   // Number of Summable Digits.
 190
 191     TObjArray    *fDtype;      // List of digits
 192     Int_t        *fNdtype;     //[fNDetTypes] Num. of digits per type of det.
 193
 194     TObjArray    *fCtype;      // List of clusters
 195     Int_t        *fNctype;     //[fNDetTypes] Num. of clust. per type of det.
 196     TTree        *fTreeC;      // Tree for raw clusters
 197
 198     TClonesArray *fRecPoints;  // List of reconstructed points
 199     Int_t         fNRecPoints; // Number of rec points
 200
 201     ClassDef(AliITS,1) // Base class for ITS
 202 };
 203
 204 #endif