ITS/AliITSClusterFinderV2SDD.cxx

   1 /**************************************************************************
   2  * Copyright(c) 1998-2003, ALICE Experiment at CERN, All rights reserved. *
   3  *                                                                        *
   4  * Author: The ALICE Off-line Project.                                    *
   5  * Contributors are mentioned in the code where appropriate.              *
   6  *                                                                        *
   7  * Permission to use, copy, modify and distribute this software and its   *
   8  * documentation strictly for non-commercial purposes is hereby granted   *
   9  * without fee, provided that the above copyright notice appears in all   *
  10  * copies and that both the copyright notice and this permission notice   *
  11  * appear in the supporting documentation. The authors make no claims     *
  12  * about the suitability of this software for any purpose. It is          *
  13  * provided "as is" without express or implied warranty.                  *
  14  **************************************************************************/
  15
  16 /* $Id$*/
  17
  18 ////////////////////////////////////////////////////////////////////////////
  19 //            Implementation of the ITS clusterer V2 class                //
  20 //                                                                        //
  21 //          Origin: Iouri Belikov, CERN, Jouri.Belikov@cern.ch            //
  22 //                                                                        //
  23 ///////////////////////////////////////////////////////////////////////////
  24
  25
  26
  27 #include <TClonesArray.h>
  28 #include "AliITSClusterFinderV2SDD.h"
  29 #include "AliITSRecPoint.h"
  30 #include "AliITSDetTypeRec.h"
  31 #include "AliRawReader.h"
  32 #include "AliITSRawStreamSDD.h"
  33 #include "AliITSRawStreamSDDCompressed.h"
  34 #include "AliITSCalibrationSDD.h"
  35 #include "AliITSresponseSDD.h"
  36 #include "AliITSDetTypeRec.h"
  37 #include "AliITSReconstructor.h"
  38 #include "AliITSsegmentationSDD.h"
  39 #include "AliITSdigitSDD.h"
  40 #include "AliITSgeomTGeo.h"
  41
  42 ClassImp(AliITSClusterFinderV2SDD)
  43
  44 AliITSClusterFinderV2SDD::AliITSClusterFinderV2SDD(AliITSDetTypeRec* dettyp):AliITSClusterFinder(dettyp)
  45 {
  46
  47   //Default constructor
  48
  49 }
  50
  51
  52 void AliITSClusterFinderV2SDD::FindRawClusters(Int_t mod){
  53
  54   //Find clusters V2
  55   SetModule(mod);
  56   FindClustersSDD(fDigits);
  57
  58 }
  59
  60 void AliITSClusterFinderV2SDD::FindClustersSDD(TClonesArray *digits) {
  61   //------------------------------------------------------------
  62   // Actual SDD cluster finder
  63   //------------------------------------------------------------
  64   Int_t nAnodes = GetSeg()->NpzHalf();
  65   Int_t nzBins = nAnodes+2;
  66   Int_t nTimeBins = GetSeg()->Npx();
  67   Int_t nxBins = nTimeBins+2;
  68   const Int_t kMaxBin=nzBins*nxBins;
  69
  70   AliBin *bins[2];
  71   bins[0]=new AliBin[kMaxBin];
  72   bins[1]=new AliBin[kMaxBin];
  73   AliITSCalibrationSDD* cal = (AliITSCalibrationSDD*)GetResp(fModule);
  74   if(cal==0){
  75     AliError(Form("Calibration object not present for SDD module %d\n",fModule));
  76     return;
  77   }
  78
  79   AliITSdigitSDD *d=0;
  80   Int_t i, ndigits=digits->GetEntriesFast();
  81   for (i=0; i<ndigits; i++) {
  82      d=(AliITSdigitSDD*)digits->UncheckedAt(i);
  83      Int_t ian=d->GetCoord1();
  84      Int_t itb=d->GetCoord2();
  85      Int_t iSide=0;
  86      if (ian >= nAnodes) iSide=1;
  87      Float_t gain=cal->GetChannelGain(ian)/fDetTypeRec->GetAverageGainSDD();
  88      Float_t charge=d->GetSignal(); // returns expanded signal
  89                                     // (10 bit, low threshold already added)
  90      Float_t baseline = cal->GetBaseline(ian);
  91      if(charge>baseline) charge-=baseline;
  92      else charge=0;
  93
  94      if(gain>0.){ // Bad channels have gain=0.
  95        charge/=gain;
  96        if(charge<cal->GetThresholdAnode(ian)) continue;
  97        Int_t q=(Int_t)(charge+0.5);
  98        Int_t y=itb+1;
  99        Int_t z=ian+1;
 100        if (z <= nAnodes){
 101          bins[0][y*nzBins+z].SetQ(q);
 102          bins[0][y*nzBins+z].SetMask(1);
 103          bins[0][y*nzBins+z].SetIndex(i);
 104        } else {
 105          z-=nAnodes;
 106          bins[1][y*nzBins+z].SetQ(q);
 107          bins[1][y*nzBins+z].SetMask(1);
 108          bins[1][y*nzBins+z].SetIndex(i);
 109        }
 110      }
 111   }
 112
 113   FindClustersSDD(bins, kMaxBin, nzBins, digits);
 114
 115   delete[] bins[0];
 116   delete[] bins[1];
 117
 118 }
 119
 120 void AliITSClusterFinderV2SDD::
 121 FindClustersSDD(AliBin* bins[2], Int_t nMaxBin, Int_t nzBins,
 122                 TClonesArray *digits, TClonesArray *clusters, Int_t jitter) {
 123   //------------------------------------------------------------
 124   // Actual SDD cluster finder
 125   //------------------------------------------------------------
 126
 127   static AliITSRecoParam *repa = NULL;
 128   if(!repa){
 129     repa = (AliITSRecoParam*) AliITSReconstructor::GetRecoParam();
 130     if(!repa){
 131       repa = AliITSRecoParam::GetHighFluxParam();
 132       AliWarning("Using default AliITSRecoParam class");
 133     }
 134   }
 135   const TGeoHMatrix *mT2L=AliITSgeomTGeo::GetTracking2LocalMatrix(fModule);
 136   AliITSCalibrationSDD* cal = (AliITSCalibrationSDD*)GetResp(fModule);
 137   if(cal==0){
 138     AliError(Form("Calibration object not present for SDD module %d\n",fModule));
 139     return;
 140   }
 141   Int_t ncl=0;
 142   TClonesArray &cl=*clusters;
 143   for (Int_t s=0; s<2; s++)
 144     for (Int_t i=0; i<nMaxBin; i++) {
 145       if(NoiseSuppress(i,s,nzBins,bins[s],cal)) continue;
 146       if (bins[s][i].IsUsed()) continue;
 147       Int_t idx[32]; UInt_t msk[32]; Int_t npeaks=0;
 148       FindPeaks(i, nzBins, bins[s], idx, msk, npeaks);
 149
 150       if (npeaks>30) continue;
 151       if (npeaks==0) continue;
 152
 153       Int_t k,l;
 154       for (k=0; k<npeaks-1; k++){//mark adjacent peaks
 155         if (idx[k] < 0) continue; //this peak is already removed
 156         for (l=k+1; l<npeaks; l++) {
 157           if (idx[l] < 0) continue; //this peak is already removed
 158           Int_t ki=idx[k]/nzBins, kj=idx[k] - ki*nzBins;
 159           Int_t li=idx[l]/nzBins, lj=idx[l] - li*nzBins;
 160           Int_t di=TMath::Abs(ki - li);
 161           Int_t dj=TMath::Abs(kj - lj);
 162           if (di>1 || dj>1) continue;
 163           if (bins[s][idx[k]].GetQ() > bins[s][idx[l]].GetQ()) {
 164             msk[l]=msk[k];
 165             idx[l]*=-1;
 166           } else {
 167             msk[k]=msk[l];
 168             idx[k]*=-1;
 169             break;
 170           }
 171         }
 172       }
 173
 174       for (k=0; k<npeaks; k++) {
 175         if(repa->GetUseUnfoldingInClusterFinderSDD()==kFALSE) msk[k]=msk[0];
 176         MarkPeak(TMath::Abs(idx[k]), nzBins, bins[s], msk[k]);
 177       }
 178
 179       for (k=0; k<npeaks; k++) {
 180         if (idx[k] < 0) continue; //removed peak
 181         AliITSRecPoint c;
 182         MakeCluster(idx[k], nzBins, bins[s], msk[k], c);
 183         //mi change
 184         Int_t milab[10];
 185         for (Int_t ilab=0;ilab<10;ilab++){
 186           milab[ilab]=-2;
 187         }
 188         Int_t maxi=0,mini=0,maxj=0,minj=0;
 189
 190         for (Int_t di=-2; di<=2;di++){
 191           for (Int_t dj=-3;dj<=3;dj++){
 192             Int_t index = idx[k]+di+dj*nzBins;
 193             if (index<0) continue;
 194             if (index>=nMaxBin) continue;
 195             AliBin *b=&bins[s][index];
 196             Int_t nAnode=index%nzBins-1;
 197             Int_t adcSignal=b->GetQ();
 198             if(adcSignal>cal->GetThresholdAnode(nAnode)){
 199               if (di>maxi) maxi=di;
 200               if (di<mini) mini=di;
 201               if (dj>maxj) maxj=dj;
 202               if (dj<minj) minj=dj;
 203             }
 204             //
 205             if(digits) {
 206               if (TMath::Abs(di)<2&&TMath::Abs(dj)<2){
 207                 AliITSdigitSDD* d=(AliITSdigitSDD*)digits->UncheckedAt(b->GetIndex());
 208                 for (Int_t itrack=0;itrack<10;itrack++){
 209                   Int_t track = (d->GetTracks())[itrack];
 210                   if (track>=0) {
 211                     AddLabel(milab, track);
 212                   }
 213                 }
 214               }
 215             }
 216           }
 217         }
 218
 219         AliITSresponseSDD* rsdd = fDetTypeRec->GetResponseSDD();
 220         Float_t y=c.GetY(),z=c.GetZ(), q=c.GetQ();
 221         y/=q; z/=q;
 222         Float_t zAnode=z-0.5;  // to have anode in range 0.-255. and centered on the mid of the pitch
 223         Float_t timebin=y-0.5;  // to have time bin in range 0.-255. amd centered on the mid of the bin
 224         if(s==1) zAnode += GetSeg()->NpzHalf();  // right side has anodes from 256. to 511.
 225         Float_t zdet = GetSeg()->GetLocalZFromAnode(zAnode);
 226         Float_t driftTimeUncorr = GetSeg()->GetDriftTimeFromTb(timebin)+jitter*rsdd->GetCarlosRXClockPeriod();
 227         Float_t driftTime=driftTimeUncorr-rsdd->GetTimeZero(fModule);
 228         Float_t driftPathMicron = cal->GetDriftPath(driftTime,zAnode);
 229         const Double_t kMicronTocm = 1.0e-4;
 230         Float_t xdet=(driftPathMicron-GetSeg()->Dx())*kMicronTocm; // xdet is negative
 231         if (s==0) xdet=-xdet; // left side has positive local x
 232
 233         Float_t corrx=0, corrz=0;
 234         cal->GetCorrections(zdet,xdet,corrz,corrx,GetSeg());
 235         zdet+=corrz;
 236         xdet+=corrx;
 237
 238         Double_t loc[3]={xdet,0.,zdet},trk[3]={0.,0.,0.};
 239         mT2L->MasterToLocal(loc,trk);
 240         y=trk[1];
 241         z=trk[2];
 242
 243         q/=rsdd->GetADC2keV();  //to have MPV 1 MIP = 86.4 KeV
 244         if(cal-> IsAMAt20MHz()) q*=2.; // account for 1/2 sampling freq.
 245         Float_t hit[5] = {y, z, 0.0030*0.0030, 0.0020*0.0020, q};
 246         Int_t  info[3] = {maxj-minj+1, maxi-mini+1, fNlayer[fModule]};
 247         if (digits) {
 248           //       AliBin *b=&bins[s][idx[k]];
 249           //       AliITSdigitSDD* d=(AliITSdigitSDD*)digits->UncheckedAt(b->GetIndex());
 250           {
 251             //Int_t lab[3];
 252             //lab[0]=(d->GetTracks())[0];
 253             //lab[1]=(d->GetTracks())[1];
 254             //lab[2]=(d->GetTracks())[2];
 255             //CheckLabels(lab);
 256             CheckLabels2(milab);
 257           }
 258         }
 259         milab[3]=fNdet[fModule];
 260
 261         AliITSRecPoint cc(milab,hit,info);
 262         cc.SetType(npeaks);
 263         cc.SetDriftTime(driftTimeUncorr);
 264         if(clusters) new (cl[ncl]) AliITSRecPoint(cc);
 265         else {
 266           fDetTypeRec->AddRecPoint(cc);
 267         }
 268         ncl++;
 269       }
 270     }
 271
 272 }
 273 //______________________________________________________________________
 274 void AliITSClusterFinderV2SDD::RawdataToClusters(AliRawReader* rawReader,TClonesArray** clusters){
 275     //------------------------------------------------------------
 276   // This function creates ITS clusters from raw data
 277   //------------------------------------------------------------
 278   rawReader->Reset();
 279   AliITSRawStream* inputSDD;
 280   if(fDetTypeRec->IsHLTmodeC()==kTRUE){
 281     inputSDD=new AliITSRawStreamSDDCompressed(rawReader);
 282   }else{
 283     inputSDD=new AliITSRawStreamSDD(rawReader);
 284   }
 285
 286   AliITSDDLModuleMapSDD *ddlmap=(AliITSDDLModuleMapSDD*)fDetTypeRec->GetDDLModuleMapSDD();
 287   inputSDD->SetDDLModuleMap(ddlmap);
 288   for(Int_t iddl=0; iddl<AliITSDDLModuleMapSDD::GetNDDLs(); iddl++){
 289     for(Int_t icar=0; icar<AliITSDDLModuleMapSDD::GetNModPerDDL();icar++){
 290       Int_t iMod=ddlmap->GetModuleNumber(iddl,icar);
 291       if(iMod==-1) continue;
 292       AliITSCalibrationSDD* cal = (AliITSCalibrationSDD*)GetResp(iMod);
 293       if(cal==0){
 294         AliError(Form("Calibration object not present for SDD module %d\n",iMod));
 295         continue;
 296       }
 297       Bool_t isZeroSupp=cal->GetZeroSupp();
 298       if(isZeroSupp){
 299         for(Int_t iSid=0; iSid<2; iSid++) inputSDD->SetZeroSuppLowThreshold(iMod-240,iSid,cal->GetZSLowThreshold(iSid));
 300       }else{
 301         for(Int_t iSid=0; iSid<2; iSid++) inputSDD->SetZeroSuppLowThreshold(iMod-240,iSid,0);
 302       }
 303     }
 304   }
 305   FindClustersSDD(inputSDD,clusters);
 306   delete inputSDD;
 307 }
 308
 309 void AliITSClusterFinderV2SDD::FindClustersSDD(AliITSRawStream* input,
 310                                         TClonesArray** clusters)
 311 {
 312   //------------------------------------------------------------
 313   // Actual SDD cluster finder for raw data
 314   //------------------------------------------------------------
 315   Int_t nClustersSDD = 0;
 316   Int_t nAnodes = GetSeg()->NpzHalf();
 317   Int_t nzBins = nAnodes+2;
 318   Int_t nTimeBins = GetSeg()->Npx();
 319   Int_t nxBins = nTimeBins+2;
 320   const Int_t kMaxBin=nzBins*nxBins;
 321   AliBin *bins[2];
 322   AliBin *ddlbins[kHybridsPerDDL]; // 12 modules (=24 hybrids) of 1 DDL read "in parallel"
 323   for(Int_t iHyb=0;iHyb<kHybridsPerDDL;iHyb++) ddlbins[iHyb]=new AliBin[kMaxBin];
 324   Int_t vectModId[kModulesPerDDL];
 325   for(Int_t iMod=0; iMod<kModulesPerDDL; iMod++) vectModId[iMod]=-1;
 326
 327   // read raw data input stream
 328   while (input->Next()) {
 329     Int_t iModule = input->GetModuleID();
 330     if(iModule<0){
 331       AliWarning(Form("Invalid SDD module number %d\n", iModule));
 332       continue;
 333     }
 334     Int_t iCarlos =input->GetCarlosId();
 335     Int_t iSide = input->GetChannel();
 336     Int_t iHybrid=iCarlos*2+iSide;
 337
 338     if (input->IsCompletedModule()) {
 339       // store the module number
 340       vectModId[iCarlos]=iModule;
 341     }
 342     else if (input->IsCompletedDDL()) {
 343       // when all data from a DDL was read, search for clusters
 344       Int_t jitter=input->GetJitter();
 345       for(Int_t iMod=0; iMod<kModulesPerDDL; iMod++){
 346         if(vectModId[iMod]>=0){
 347           fModule = vectModId[iMod];
 348           clusters[fModule] = new TClonesArray("AliITSRecPoint");
 349           bins[0]=ddlbins[iMod*2];   // first hybrid of the module
 350           bins[1]=ddlbins[iMod*2+1]; // second hybrid of the module
 351           FindClustersSDD(bins, kMaxBin, nzBins, NULL, clusters[fModule],jitter);
 352           Int_t nClusters = clusters[fModule]->GetEntriesFast();
 353           nClustersSDD += nClusters;
 354           vectModId[iMod]=-1;
 355         }
 356         for(Int_t iBin=0;iBin<kMaxBin; iBin++){
 357           ddlbins[iMod*2][iBin].Reset();
 358           ddlbins[iMod*2+1][iBin].Reset();
 359         }
 360       }
 361     }else{
 362     // fill the current digit into the bins array
 363       if(iHybrid<0 || iHybrid>=kHybridsPerDDL){
 364         AliWarning(Form("Invalid SDD hybrid number %d on module %d\n", iHybrid,iModule));
 365         continue;
 366       }
 367       AliITSCalibrationSDD* cal = (AliITSCalibrationSDD*)GetResp(iModule);
 368       if(cal==0){
 369         AliError(Form("Calibration object not present for SDD module %d\n",iModule));
 370         continue;
 371       }
 372       Float_t charge=input->GetSignal();
 373       Int_t chan=input->GetCoord1()+nAnodes*iSide;
 374       Float_t gain=cal->GetChannelGain(chan)/fDetTypeRec->GetAverageGainSDD();;
 375       Float_t baseline = cal->GetBaseline(chan);
 376       if(charge>baseline) charge-=baseline;
 377       else charge=0;
 378       if(gain>0.){ // Bad channels have gain=0
 379         charge/=gain;
 380         if(charge>=cal->GetThresholdAnode(chan)) {
 381           Int_t q=(Int_t)(charge+0.5);
 382           Int_t iz = input->GetCoord1();
 383           Int_t itb = input->GetCoord2();
 384           Int_t index = (itb+1) * nzBins + (iz+1);
 385           if(index<kMaxBin){
 386             ddlbins[iHybrid][index].SetQ(q);
 387             ddlbins[iHybrid][index].SetMask(1);
 388             ddlbins[iHybrid][index].SetIndex(index);
 389           }else{
 390             AliWarning(Form("Invalid SDD cell: Anode=%d   TimeBin=%d",iz,itb));
 391           }
 392         }
 393       }
 394     }
 395   }
 396   for(Int_t iHyb=0;iHyb<kHybridsPerDDL;iHyb++) delete [] ddlbins[iHyb];
 397   Info("FindClustersSDD", "found clusters in ITS SDD: %d", nClustersSDD);
 398 }
 399
 400 //______________________________________________________________________
 401 Bool_t AliITSClusterFinderV2SDD::NoiseSuppress(Int_t k, Int_t sid,Int_t nzBins, AliBin* bins, AliITSCalibrationSDD* cal) const {
 402   // applies zero suppression using the measured noise of each anode
 403   // threshold values from ALICE-INT-1999-28 V10
 404   // returns kTRUE if the digit should eb noise suppressed, kFALSE if it should be kept
 405   Float_t xfactL=2.2;
 406   Float_t xfactH=4.0;
 407   //
 408
 409   Int_t iAn=(k%nzBins)-1;
 410   if(iAn<0 || iAn>255) return kTRUE;
 411   if(sid==1) iAn+=256;
 412   Int_t nLow=0, nHigh=0;
 413   Float_t noise=cal->GetNoiseAfterElectronics(iAn);
 414   Float_t noisem1=noise;
 415   if(iAn>1) noisem1=cal->GetNoiseAfterElectronics(iAn-1);
 416   Float_t noisep1=noise;
 417   if(iAn<511) noisep1=cal->GetNoiseAfterElectronics(iAn+1);
 418   Float_t tL=noise*xfactL;
 419   Float_t tH=noise*xfactH;
 420   Float_t tLp1=noisep1*xfactL;
 421   Float_t tHp1=noisep1*xfactH;
 422   Float_t tLm1=noisem1*xfactL;
 423   Float_t tHm1=noisem1*xfactH;
 424   Int_t cC=bins[k].GetQ();
 425   if(cC<=tL){
 426     bins[k].SetQ(0);
 427     bins[k].SetMask(0xFFFFFFFE);
 428     return kTRUE;;
 429   }
 430   nLow++; // cC is greater than tL
 431   if(cC>tH) nHigh++;
 432   Int_t sS=bins[k-1].GetQ();
 433   if(sS>tLm1) nLow++;
 434   if(sS>tHm1) nHigh++;
 435   Int_t nN=bins[k+1].GetQ();
 436   if(nN>tLp1) nLow++;
 437   if(nN>tHp1) nHigh++;
 438   Int_t eE=bins[k-nzBins].GetQ();
 439   if(eE>tL) nLow++;
 440   if(eE>tH) nHigh++;
 441   Int_t wW=bins[k+nzBins].GetQ();
 442   if(wW>tL) nLow++;
 443   if(wW>tH) nHigh++;
 444   if(nLow<3 || nHigh<1) return kTRUE;
 445   else return kFALSE;
 446 }
 447
 448
 449