]> git.uio.no Git - u/mrichter/AliRoot.git/blobdiff - MUON/AliMUONTriggerSegmentation.h
- Adapted comments for Doxygen
[u/mrichter/AliRoot.git] / MUON / AliMUONTriggerSegmentation.h
index 7f338471ecca28774d0335b02f62e33d3997f0b5..26037cd6e7adc172c2074dc5dcb0cc74a95ec600 100644 (file)
@@ -18,66 +18,67 @@ class AliMUONTriggerSegmentation : public AliMUONVGeometryDESegmentation
     AliMUONTriggerSegmentation();
     virtual ~AliMUONTriggerSegmentation();
       
-    virtual Float_t  Distance2AndOffset(Int_t /*iX*/, Int_t /*iY*/, Float_t /*X*/, Float_t /*Y*/, Int_t * /*dummy*/) {return 0.;}  // Distance between 1 pad and a position
-    virtual Float_t  Dpx() const {return 0.;}  // Pad size in x   
-    virtual Float_t  Dpy() const {return 0.;}  // Pad size in y   
+    virtual Float_t  Distance2AndOffset(Int_t /*iX*/, Int_t /*iY*/, Float_t /*X*/, Float_t /*Y*/, Int_t * /*dummy*/) {return 0.;}  ///< Distance between 1 pad and a position
+    virtual Float_t  Dpx() const {return 0.;}  ///< Pad size in x   
+    virtual Float_t  Dpy() const {return 0.;}  ///< Pad size in y   
     virtual Float_t  Dpx(Int_t isec) const;       // Pad size in x by Sector
     virtual Float_t  Dpy(Int_t isec) const;       // Pad size in y by Sector
-    virtual void     Draw(const char */*opt*/ = "") {}  // Not implemented
-    virtual void     FirstPad(Float_t /*xhit*/, Float_t /*yhit*/, Float_t /*dx*/, Float_t /*dy*/){}
-    virtual void     FirstPad(Float_t /*xhit*/, Float_t /*yhit*/, Float_t /*zhit*/, Float_t /*dx*/, Float_t /*dy*/) {}    
+    virtual void     Draw(const char */*opt*/ = "") {}  ///< Not implemented
+    virtual void     FirstPad(Float_t /*xhit*/, Float_t /*yhit*/, Float_t /*dx*/, Float_t /*dy*/){} ///< Not implemented
+    virtual void     FirstPad(Float_t /*xhit*/, Float_t /*yhit*/, Float_t /*zhit*/, Float_t /*dx*/, Float_t /*dy*/) {}  ///< Not implemented   
 
-    virtual Bool_t   HasPad(Float_t /*x*/, Float_t /*y*/, Float_t /*z*/) { return true; }
+    virtual Bool_t   HasPad(Float_t /*x*/, Float_t /*y*/, Float_t /*z*/) { return true; } ///< Not implemented
     virtual Bool_t   HasPad(Int_t ix, Int_t iy);
-    virtual AliMUONGeometryDirection  GetDirection() { return kDirUndefined; } 
-    virtual const AliMpVSegmentation* GetMpSegmentation() const { return 0; }                 
+    virtual AliMUONGeometryDirection  GetDirection() { return kDirUndefined; }  ///< Not implemented
+    virtual const AliMpVSegmentation* GetMpSegmentation() const { return 0; }   ///< Not implemented                  
 
-    virtual Float_t  GetAnod(Float_t /*xhit*/) const {return 0; }  // Anod wire coordinate closest to xhit
+    virtual Float_t  GetAnod(Float_t /*xhit*/) const {return 0; }  ///< Anod wire coordinate closest to xhit
     virtual void     GetPadI(Float_t x ,Float_t y ,Int_t   &ix,Int_t &iy);  // Transform from pad to real coordinates
     virtual void     GetPadI(Float_t x, Float_t y , Float_t z, Int_t &ix, Int_t &iy);
     virtual void     GetPadC(Int_t ix, Int_t iy, Float_t &x, Float_t &y);
+                     /// Returns real coordinates (x,y,z) for given pad coordinates (ix,iy)
     virtual void     GetPadC(Int_t ix, Int_t iy, Float_t &x, Float_t &y, Float_t &z) {z=0; GetPadC(ix, iy, x , y);}
                         
     virtual void GetPadLoc2Glo(Int_t ixLoc, Int_t iyLoc, Int_t &ixGlo, Int_t &iyGlo);
     virtual void GetPadGlo2Loc(Int_t ixLoc, Int_t iyLoc, Int_t &ixGlo, Int_t &iyGlo);
     virtual void     IntegrationLimits(Float_t& x1, Float_t& x2, Float_t& y1, Float_t& y2); //Current integration limits
-    virtual Int_t    ISector()  {return fSector;} // Current Pad during Integration (current sector)
-    virtual Int_t    Ix() {return fIx;} // x-coordinate
-    virtual Int_t    Iy() {return fIy;} // y-coordinate
+    virtual Int_t    ISector()  {return fSector;} ///< Current Pad during Integration (current sector)
+    virtual Int_t    Ix() {return fIx;} ///< x-coordinate
+    virtual Int_t    Iy() {return fIy;} ///< y-coordinate
   
 //    virtual Int_t    MorePads();  // Condition
-    virtual Int_t    MorePads(){return 0;};  // Condition
+    virtual Int_t    MorePads(){return 0;};  ///< Condition
  
     virtual void     Neighbours(Int_t iX, Int_t iY, Int_t* Nlist, Int_t Xlist[10], Int_t Ylist[10]);  // Get next neighbours
-    virtual void     NextPad(){} // Stepper
+    virtual void     NextPad(){} ///< Stepper
     
-    virtual Int_t    Npx() const {return fNpx;} // Maximum number of Pads in x
-    virtual Int_t    Npy() const {return fNpy;} // Maximum number of Pads in y
+    virtual Int_t    Npx() const {return fNpx;} ///< Maximum number of Pads in x
+    virtual Int_t    Npy() const {return fNpy;} ///< Maximum number of Pads in y
 
-    virtual void     SetDAnod(Float_t /*D*/) {/*fWireD = D*/;};  // Anod pitch
+    virtual void     SetDAnod(Float_t /*D*/) {/*fWireD = D*/;};  ///< Anod pitch
     virtual Int_t    Sector(Int_t ix, Int_t iy);         // Calculate sector from pad coordinates
     virtual void     SetHit(Float_t xhit, Float_t yhit); // Set hit position
     virtual void     SetHit(Float_t xhit, Float_t yhit, Float_t zhit);
-    virtual void     SetId(Int_t id) {fId=id;}  // Setting detection element
-    virtual void     SetPad(Int_t ix, Int_t iy);         // Set pad position
-    virtual void     SetPadDivision(Int_t /*ndiv[4]*/){} // Set Slat Segmentation Parameters
-    virtual void     SetPadSize(Float_t /*p1*/, Float_t /*p2*/){;}; // Pad size Dx*Dy 
-    virtual void     SetPcbBoards(Int_t /*n[4]*/){}           // Set Segmentation Zones (PCB Boards)
+    virtual void     SetId(Int_t id) {fId=id;}  ///< Setting detection element
+    virtual void     SetPad(Int_t ix, Int_t iy);         //   Set pad position
+    virtual void     SetPadDivision(Int_t /*ndiv[4]*/){} ///< Set Slat Segmentation Parameters
+    virtual void     SetPadSize(Float_t /*p1*/, Float_t /*p2*/){;}; ///< Pad size Dx*Dy 
+    virtual void     SetPcbBoards(Int_t /*n[4]*/){}           ///< Set Segmentation Zones (PCB Boards)
 // add to St345SlatSegmentation
     virtual void     SetLineNumber(Int_t iLineNumber);
     virtual Int_t    ModuleColNum(Int_t ixGlo);
 // add to St345SlatSegmentation
     
     // The following function could be obsolet for this class, but they are pure virtual in AliSegmentation
-    virtual void     GetNParallelAndOffset(Int_t /*iX*/, Int_t /*iY*/, Int_t */*Nparallel*/, Int_t */*Offset*/){};
-    virtual Int_t    SigGenCond(Float_t /*x*/, Float_t /*y*/, Float_t /*z*/){return 0;} ;  // Signal Generation Condition during Stepping
-    virtual void     SigGenInit(Float_t /*x*/, Float_t /*y*/, Float_t /*z*/){};  // Initialise signal gneration at coord (x,y,z)
-    virtual void     GiveTestPoints(Int_t &/*n*/, Float_t * /*x*/, Float_t */*y*/) const{};   // Test points for auto calibration
-    virtual void     SetCorrFunc(Int_t /*dum*/, TF1* /*func*/){}; // Function for systematic corrections, Set the correction function
-    virtual TF1*     CorrFunc(Int_t) const {return 0x0;} // Get the correction Function
+    virtual void     GetNParallelAndOffset(Int_t /*iX*/, Int_t /*iY*/, Int_t */*Nparallel*/, Int_t */*Offset*/){};///< Not implemented
+    virtual Int_t    SigGenCond(Float_t /*x*/, Float_t /*y*/, Float_t /*z*/){return 0;} ;  ///< Signal Generation Condition during Stepping
+    virtual void     SigGenInit(Float_t /*x*/, Float_t /*y*/, Float_t /*z*/){};  ///< Initialise signal gneration at coord (x,y,z)
+    virtual void     GiveTestPoints(Int_t &/*n*/, Float_t * /*x*/, Float_t */*y*/) const{};   ///< Test points for auto calibration
+    virtual void     SetCorrFunc(Int_t /*dum*/, TF1* /*func*/){}; ///< Function for systematic corrections, Set the correction function
+    virtual TF1*     CorrFunc(Int_t) const {return 0x0;} ///< Get the correction Function
     virtual Int_t    Sector(Float_t /*x*/, Float_t /*y*/) {return 1;}
 
-    virtual void     Init(Int_t /*detectionElementId*/){} // Initialisation
+    virtual void     Init(Int_t /*detectionElementId*/){} ///< Initialisation
     virtual void     Init(Int_t detectionElementId,                     
                          Int_t nStrip[7],
                          Float_t stripYsize[7],
@@ -92,36 +93,36 @@ class AliMUONTriggerSegmentation : public AliMUONVGeometryDESegmentation
     AliMUONTriggerSegmentation& operator=(const AliMUONTriggerSegmentation& rhs);
     
     //  Internal geometry 
-    Bool_t      fBending;        // 0: Bending or 1:Non Bending segmentation
-    Int_t       fId;             // Identifier of detection element
-    Int_t       fNsec;           // Number of density sectors 
-    Int_t       fNpx;            // Number of pads in x
-    Int_t       fNpy;            // Number of pads in y
-    Int_t       fSector;         // Current density sector
+    Bool_t      fBending;        ///< 0: Bending or 1:Non Bending segmentation
+    Int_t       fId;             ///< Identifier of detection element
+    Int_t       fNsec;           ///< Number of density sectors 
+    Int_t       fNpx;            ///< Number of pads in x
+    Int_t       fNpy;            ///< Number of pads in y
+    Int_t       fSector;         ///< Current density sector
 
     // Current pad and wire during tracking (cursor at hit centre)
-    Float_t     fXhit;  // ! x-position of hit
-    Float_t     fYhit;  // ! y-position of hit
+    Float_t     fXhit;  //!< x-position of hit
+    Float_t     fYhit;  //!< y-position of hit
 
     // Current pad and wire during tracking (cursor at hit centre)
-    Int_t       fIx;   // ! pad coord.  x 
-    Int_t       fIy;   // ! pad coord.  y 
-    Float_t     fX;    // ! real coord. x
-    Float_t     fY;    // ! real ccord. y
+    Int_t       fIx;   //!< pad coord.  x 
+    Int_t       fIy;   //!< pad coord.  y 
+    Float_t     fX;    //!< real coord. x
+    Float_t     fY;    //!< real ccord. y
     
 // add to St345SlatSegmentation
-    Int_t fLineNumber;        // line number of the RPC (1:9 - top:bottom)
-    Int_t fNstrip[7];         // number of strips per module in RPC
-    Float_t fStripYsize[7];   // strip Y size per module in RPC
-    Float_t fStripXsize[7];   // strip X size per module in RPC
-    Float_t fModuleXmin[7];   // x min position of modules
-    Float_t fModuleXmax[7];   // x max position of modules
-    Float_t fModuleYmin[7];   // y min position of modules
-    Float_t fRpcHalfXsize;    // RPC half size in x 
-    Float_t fRpcHalfYsize;    // RPC half size in y
+    Int_t fLineNumber;        ///< line number of the RPC (1:9 - top:bottom)
+    Int_t fNstrip[7];         ///< number of strips per module in RPC
+    Float_t fStripYsize[7];   ///< strip Y size per module in RPC
+    Float_t fStripXsize[7];   ///< strip X size per module in RPC
+    Float_t fModuleXmin[7];   ///< x min position of modules
+    Float_t fModuleXmax[7];   ///< x max position of modules
+    Float_t fModuleYmin[7];   ///< y min position of modules
+    Float_t fRpcHalfXsize;    ///< RPC half size in x 
+    Float_t fRpcHalfYsize;    ///< RPC half size in y
 // add to St345SlatSegmentation
     
-    ClassDef(AliMUONTriggerSegmentation,1) 
+    ClassDef(AliMUONTriggerSegmentation,1) // Trigger segmentation
 };
 #endif