RICH/AliRICHDigitN.cxx

   1 //  **************************************************************************
   2 //  * Copyright(c) 1998-1999, 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 #include "AliRICHDigitN.h"//class header
  17 #include <TCanvas.h>     //TestSeg()
  18 #include <TLine.h>       //TestSeg()
  19 #include <TLatex.h>      //TestSeg()
  20 #include <TPolyLine.h>   //DrawPc()
  21 #include <TGStatusBar.h> //Zoom()
  22 #include <TRootCanvas.h> //Zoom()
  23 ClassImp(AliRICHDigitN)
  24
  25 /*
  26 Any given LDC collects data from a number of D-RORC cards connected to this same LDC by separate DDLs. This data is stored in corresponding number
  27 of DDL buffers.
  28
  29 Each DDL buffer corresponds to a single D-RORC. The data this buffer contains are hardware generated by D-RORC. The buffer starts with common header
  30 which size and structure is standartized and mandatory for all detectors.
  31 The header contains among other words, so called Equipment ID word. This unique value for each D-RORC is calculated as detector ID << 8 + DDL index.
  32 For RICH the detector ID is 6 (reffered in the code as kRichRawId) while DDL indexes are from 0 to 13.
  33
  34 Common header might be followed by the private one although  RICH has no any private header, just uses the common one.
  35
  36 Single RICH D-RORC serves one half of a chamber i.e. 3 photocathodes even LDC for left part( PCs 0-2-4) and odd LDC for right part(1-3-5)
  37 as it's seen from electronics side.
  38
  39 So the LDC -chamber-ddl map is:
  40 DDL index  0 -> ch 1 left -> DDL ID 0x600          DDL index  1 -> ch 1 right -> DDL ID 0x601
  41 DDL index  2 -> ch 2 left -> DDL ID 0x602          DDL index  3 -> ch 2 right -> DDL ID 0x603
  42 DDL index  4 -> ch 3 left -> DDL ID 0x604          DDL index  5 -> ch 3 right -> DDL ID 0x605
  43 DDL index  6 -> ch 4 left -> DDL ID 0x606          DDL index  7 -> ch 4 right -> DDL ID 0x607
  44 DDL index  8 -> ch 5 left -> DDL ID 0x608          DDL index  9 -> ch 5 right -> DDL ID 0x609
  45 DDL index 10 -> ch 6 left -> DDL ID 0x60a          DDL index 11 -> ch 6 right -> DDL ID 0x60b
  46 DDL index 12 -> ch 7 left -> DDL ID 0x60c          DDL index 13 -> ch 7 right -> DDL ID 0x60d
  47
  48 RICH FEE as seen by single D-RORC is composed from a number of DILOGIC chips organized in vertical stack of rows.
  49 Each DILOGIC chip serves 48 channels for the 8x6 pads (reffered in the code as kDilX,kDilY). Channels counted from 0 to 47.
  50
  51 The mapping inside DILOGIC chip has the following structure (see from electronics side):
  52
  53 5  04 10 16 22 28 34 40 46
  54 4  02 08 14 20 26 32 38 44
  55 3  00 06 12 18 24 30 36 42
  56 2  01 07 13 19 25 31 37 43
  57 1  03 09 15 21 27 33 39 45
  58 0  05 11 17 23 29 35 41 47
  59
  60     0  1  2  3  4  5  6  7  padx
  61
  62 10 DILOGIC chips composes so called "row" in horizontal direction (reffered in the code as kNdil), so the row is 80x6 pads structure.
  63 DILOGIC chips in the row are counted from right to left as seen from electronics side, from 1 to 10.
  64 24 rows are piled up forming the whole FEE served by single D-RORC, so one DDL sees 80x144 pads separated in 3 photocathodes.
  65 Rows are counted from 1 to 24 from top    to bottom for right  half of the chamber (PCs 1-3-5) as seen from electronics side, meaning even LDC number
  66                           and from bottom to top    for left   half of the chamber (PCs 0-2-4) as seen from electronics side, meaning odd LDC number.
  67
  68 RICH raw word is 32 bits with the structure:
  69    00000             rrrrr                      dddd                               aaaaaa                          qqqqqqqqqqqq
  70  5 bits zero  5 bits row number (1..24)  4 bits DILOGIC chip number (1..10) 6 bits DILOGIC address (0..47)  12 bits QDC value (0..4095)
  71 */
  72 //++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  73 void AliRICHDigitN::Print(Option_t*)const
  74 {
  75 // Print current digit
  76 // Arguments: option string not used
  77 //   Returns: none
  78   Printf("pad=(%2i,%2i,%3i,%3i),pos=(%.2f,%.2f) QDC=%8.3f, TID=(%5i,%5i,%5i) raw r=%2i d=%2i a=%2i",
  79                Ch(),Pc(),PadX(),PadY(),LorsX(),LorsY(), Qdc(),  fTracks[0],fTracks[1],fTracks[2], Row(), Dilogic(), Addr());
  80 }
  81 //++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  82 void AliRICHDigitN::PrintSize()
  83 {
  84 // Print all segmentaion related sizes
  85 // Arguments: none
  86 //   Returns: none
  87   Printf("-->pad    =(%6.2f,%6.2f) cm dead zone %.2f cm\n"
  88          "-->PC     =(%6.2f,%6.2f) cm\n"
  89          "-->all PCs=(%6.2f,%6.2f) cm",
  90                SizePadX(),SizePadY(),SizeDead(),SizePcX(),SizePcY(),SizeAllX(),SizeAllY());
  91 }
  92 //++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  93 void AliRICHDigitN::TestSeg()
  94 {
  95 // Draws the picture of segmentation
  96 // Arguments: none
  97 //   Returns: none
  98   TCanvas *pC=new TCanvas("pads","View from electronics side, IP is behind the picture.");pC->ToggleEventStatus();
  99   gPad->AddExec("test","AliRICHDigitN::Zoom()");
 100   DrawPc();
 101 }//TestSeg()
 102 //++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 103 void AliRICHDigitN::Zoom()
 104 {
 105 // Show info about current cursur position in status bar of the canvas
 106 // Arguments: none
 107 //   Returns: none
 108   TCanvas *pC=(TCanvas*)gPad;
 109   TRootCanvas *pRC= (TRootCanvas*)pC->GetCanvasImp();
 110   TGStatusBar *pBar=pRC->GetStatusBar();
 111   pBar->SetParts(5);
 112   Float_t x=gPad->AbsPixeltoX(gPad->GetEventX());
 113   Float_t y=gPad->AbsPixeltoY(gPad->GetEventY());
 114   AliRICHDigitN dig(1,x,y,100);
 115   pBar->SetText(Form("(p=%i,x=%i,y=%i)  (r%i d%i a%i)",dig.Pc(),dig.PadX(),dig.PadY(),dig.Row(),dig.Dilogic(),dig.Addr()),4);
 116   if(gPad->GetEvent()==1){
 117     new TCanvas("zoom",Form("Row %i DILOGIC %i",dig.Row(),dig.Dilogic()));
 118   }
 119 }
 120 //++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 121 void AliRICHDigitN::DrawPc()
 122 {
 123 // Utility methode draws RICH chamber PCs on event display.
 124 // Arguments: none
 125 //   Returns: none
 126 //  y6  ----------  ----------
 127 //      |        |  |        |
 128 //      |    4   |  |    5   |
 129 //  y5  ----------  ----------
 130 //
 131 //  y4  ----------  ----------
 132 //      |        |  |        |
 133 //      |    2   |  |    3   |   view from electronic side
 134 //  y3  ----------  ----------
 135 //
 136 //  y2  ----------  ----------
 137 //      |        |  |        |
 138 //      |    0   |  |    1   |
 139 //  y1  ----------  ----------
 140 //      x1      x2  x3       x4
 141   gPad->Range(-5,-5,SizeAllX()+5,SizeAllY()+5);
 142   Float_t x1=0,x2=SizePcX(),x3=SizePcX()+SizeDead(),                                                  x4=SizeAllX();
 143   Float_t y1=0,y2=SizePcY(),y3=SizePcY()+SizeDead(),y4=2*SizePcY()+SizeDead(),y5=SizeAllY()-SizePcY(),y6=SizeAllY();
 144
 145   Float_t xL[5]={x1,x1,x2,x2,x1}; //clockwise
 146   Float_t xR[5]={x3,x3,x4,x4,x3};
 147   Float_t yD[5]={y1,y2,y2,y1,y1};
 148   Float_t yC[5]={y3,y4,y4,y3,y3};
 149   Float_t yU[5]={y5,y6,y6,y5,y5};
 150
 151   TLatex t; t.SetTextSize(0.01); t.SetTextAlign(22);
 152   Int_t iColLeft=29,iColRight=41;
 153   TPolyLine *pc=0;  TLine *pL; Float_t x0=0,y0=0,wRow=kDilY*SizePadY(),wDil=kDilX*SizePadX();
 154   for(Int_t iPc=0;iPc<kNpc;iPc++){
 155     if(iPc==4) {pc=new TPolyLine(5,xL,yU);t.DrawText(x1-3.5,y6-20,"PC4");x0=x1;y0=y5;} if(iPc==5) {pc=new TPolyLine(5,xR,yU);t.DrawText(x4+3.5,y6-20,"PC5");x0=x3;y0=y5;}
 156     if(iPc==2) {pc=new TPolyLine(5,xL,yC);t.DrawText(x1-3.5,y4-20,"PC2");x0=x1;y0=y3;} if(iPc==3) {pc=new TPolyLine(5,xR,yC);t.DrawText(x4+3.5,y4-20,"PC3");x0=x3;y0=y3;}
 157     if(iPc==0) {pc=new TPolyLine(5,xL,yD);t.DrawText(x1-3.5,y2-20,"PC0");x0=x1;y0=y1;} if(iPc==1) {pc=new TPolyLine(5,xR,yD);t.DrawText(x4+3.5,y2-20,"PC1");x0=x3;y0=y1;}
 158     (iPc%2)? pc->SetFillColor(iColLeft): pc->SetFillColor(iColRight);
 159     pc->Draw("f");
 160     for(Int_t i=1;i<=8 ;i++){//draw row lines (horizontal)
 161       Float_t y=y0+i*wRow;
 162       Int_t row=i+iPc/2*8; if(iPc%2!=0) row=25-row; t.DrawText(x0-1,y -3,Form("r%i",row));
 163       if(i==8) break;                                      //do not draw the last line of PC
 164       pL=new TLine(x0,y,x0+SizePcX(),y);   pL->Draw();
 165     }
 166     for(Int_t iDil=1;iDil<=10;iDil++){Float_t x=x0+iDil*wDil;t.DrawText(x -3,y0-1,Form("d%i",11-iDil));   if(iDil==10) break;    pL=new TLine(x,y0,x,y0+SizePcY());  pL->Draw();}
 167   }
 168 }//DrawPc()