Coding conventions (Philippe)
authorhristov <hristov@f7af4fe6-9843-0410-8265-dc069ae4e863>
Wed, 26 Apr 2006 15:12:21 +0000 (15:12 +0000)
committerhristov <hristov@f7af4fe6-9843-0410-8265-dc069ae4e863>
Wed, 26 Apr 2006 15:12:21 +0000 (15:12 +0000)
13 files changed:
MUON/AliMUONGlobalTrigger.cxx
MUON/AliMUONLocalTrigger.cxx
MUON/AliMUONLocalTrigger.h
MUON/AliMUONResponseTriggerV1.cxx
MUON/AliMUONTriggerCircuit.cxx
MUON/AliMUONTriggerCircuit.h
MUON/AliMUONTriggerConstants.cxx
MUON/AliMUONTriggerDecision.cxx
MUON/AliMUONTriggerDecision.h
MUON/AliMUONTriggerGeometryBuilder.cxx
MUON/AliMUONTriggerGeometryBuilder.h
MUON/AliMUONTriggerLut.cxx
MUON/AliMUONTriggerTrack.cxx

index f93cd5d..16c4e32 100644 (file)
 
 /* $Id$ */
 
+// ------------------
+// Class AliMUONGlobalTrigger
+// ------------------
+// Global Trigger algorithm data output
+// built from Local and Regional algorithms 
+
 #include "AliMUONGlobalTrigger.h"
 
 ClassImp(AliMUONGlobalTrigger)
index 7203c38..9fec7cf 100644 (file)
 
 /* $Id$ */
 
+// ------------------
+// Class AliMUONLocalTrigger
+// ------------------
+// Local Trigger algorithm data outputs
+// (contains local trigger decision and bit patterns)
+
 #include "AliMUONLocalTrigger.h"
 #include <assert.h>
 #include "AliLog.h"
@@ -135,6 +141,7 @@ AliMUONLocalTrigger::AliMUONLocalTrigger(const Int_t* localtr, const TArrayI& di
 //----------------------------------------------------------------------
 Char_t AliMUONLocalTrigger::GetLoDecision()
 {
+// returns local trigger decision
   fLoDecision  = (fLoLpt & 0x3);
   fLoDecision |= (fLoHpt << 2) & 0xC;
 
index 3b068c5..501f487 100644 (file)
@@ -80,15 +80,15 @@ private:
   Int_t fLoHpt;     // High pt 0 : nothing, 1 : Minus, 2 : Plus, 3 : Undef
   Int_t fLoApt;     // All pt  0 : nothing, 1 : Minus, 2 : Plus, 3 : Undef
 
-  UShort_t fX1Pattern; // X and Y strip pattern for each chamber
-  UShort_t fX2Pattern;
-  UShort_t fX3Pattern;
-  UShort_t fX4Pattern;
+  UShort_t fX1Pattern; // X strip pattern for chamber 11
+  UShort_t fX2Pattern; // X strip pattern for chamber 12
+  UShort_t fX3Pattern; // X strip pattern for chamber 21
+  UShort_t fX4Pattern; // X strip pattern for chamber 22
  
-  UShort_t fY1Pattern;
-  UShort_t fY2Pattern;
-  UShort_t fY3Pattern;
-  UShort_t fY4Pattern;
+  UShort_t fY1Pattern; // Y strip pattern for chamber 11
+  UShort_t fY2Pattern; // Y strip pattern for chamber 12
+  UShort_t fY3Pattern; // Y strip pattern for chamber 21
+  UShort_t fY4Pattern; // Y strip pattern for chamber 22
 
   Char_t fLoDecision; // local decision word (4 bits)
 
index 5688f71..62b9969 100644 (file)
 
 /* $Id$ */
 
+// ------------------
+// Class AliMUONTriggerResponseV1
+// ------------------
+// Trigger chamber response 
+// with cluster size activated
+
 #include <TMath.h>
 #include <TRandom.h>
 
index 65dd019..15cd8ef 100644 (file)
 
 /* $Id$ */
 
+// ------------------
+// Class AliMUONTriggerCircuit
+// ------------------
+// description of the global position of the trigger boards strip positions
+// based on the "old" segmentation (to be replaced soon)
+
+
 #include <TMath.h>
 
 #include "AliMUONTriggerCircuit.h"
@@ -396,7 +403,7 @@ void AliMUONTriggerCircuit::LoadXPos2(){
   Int_t nStrY=AliMUONTriggerConstants::NstripY(ModuleNumber(idModule)); 
   Int_t idSector=segmentation->Sector(idDE, idModule,0); // corresp. sector
   Float_t width=segmentation->Dpx(idDE, idSector);      // corresponding strip width
-  
+
 // first case : up middle and down parts have all 8 or 16 strip 
   if ((nStrY==16)||(nStrY==8&&fX2m==0&&fX2ud==0)) { 
     for (istrip=0; istrip<nStrY; istrip++) {
@@ -544,6 +551,7 @@ void dump(const char* what, const Int_t* array, Int_t size)
 void
 AliMUONTriggerCircuit::Print(Option_t* ) const
 {
+// prints-out data member
   cout << "IdCircuit " << fIdCircuit << " X2m,X2ud=" << fX2m << ","
   << fX2ud;
   for ( Int_t i = 0; i < 2; ++i )
index a74fcf5..951ff0f 100644 (file)
@@ -9,6 +9,8 @@
 /// \ingroup base
 /// \class AliMUONTriggerCircuit
 /// \brief MUON Trigger circuit
+///
+/// \author Philippe Crochet (LPCCFd)
 
 #include <TObject.h>
 #include <TObjArray.h>
index b0c84a5..9b15b33 100644 (file)
 
 /* $Id$ */
 
+// ------------------
+// Class AliMUONTriggerConstants
+// ------------------
+// constants for building the trigger segmentation
+// to be removed soon (the next version is based on mapping only)
+
 #include "AliMUONTriggerConstants.h"
 
 ClassImp(AliMUONTriggerConstants)
index 8a487c1..a3911a6 100644 (file)
 
 /* $Id$ */
 
+// ------------------
+// Class AliMUONTriggerDecision
+// ------------------
+// The (very-old) version of the trigger algorithm.
+// to be removed soon (the current version is AliMUONTriggerDecisionV1)
+
+
 #include <TError.h>
 
 #include "AliMUONTriggerCircuit.h"
@@ -138,6 +145,7 @@ AliMUONTriggerDecision::AliMUONTriggerDecision(const AliMUONTriggerDecision& rhs
 //----------------------------------------------------------------------
 void AliMUONTriggerDecision::ClearDigits()
 {
+// cleaning digits
   for ( int i=0;i<AliMUONConstants::NCh();i++ )
   {
     if ((*fDigits)[i]) ((TClonesArray*)fDigits->At(i))->Clear();
index dc6b3c2..93779c3 100644 (file)
@@ -11,9 +11,8 @@
 /// \class AliMUONTriggerDecision
 /// \brief MUON trigger decision class 
 ///
-/////////////////////////////////////////////////
-///  MUON Trigger Decision Class               //
-/////////////////////////////////////////////////
+/// \author Philippe Crochet (LPCCFd)
+
 
 #include <TObject.h>
 #include "AliMUONLocalTrigger.h"
index ec903c7..c58891c 100644 (file)
  **************************************************************************/
 
 // $Id$
-//
+
+// -----------------------------------
 // Class AliMUONTriggerGeometryBuilder
 // -----------------------------------
-// MUON Trigger stations geometry construction class.
-//
-// Author: Philippe Crochette, LPC Clermont-Ferrand
+// MUON Trigger stations geometry 
+// construction class.
+// Author: Philippe Crochet (LPCCFd)
 
 #include <TVirtualMC.h>
 #include <TGeoMatrix.h>
index 52927d4..9e278d0 100644 (file)
@@ -8,7 +8,7 @@
 /// \class AliMUONTriggerGeometryBuilder
 /// \brief MUON Trigger stations geometry construction class
 ///
-/// Author: Philippe Crochette, LPC Clermont-Ferrand
+/// \author Philippe Crochet (LPCCFd)
 
 #ifndef ALI_MUON_TRIGGER_GEOMETRY_BUILDER_H
 #define ALI_MUON_TRIGGER_GEOMETRY_BUILDER_H
index 40bf136..9e8dd59 100644 (file)
 
 /* $Id$ */
 
+// -----------------------------------
+// Class AliMUONTriggerLut
+// -----------------------------------
+// Local Trigger Look Up Table - reading interface
+// LUT data is stored into TH3S histograms and readout 
+// from the Local Trigger algorithm.
+
 #include "AliMUONTriggerLut.h"
 
 #include "AliLog.h"
@@ -73,6 +80,7 @@ AliMUONTriggerLut::operator=(const AliMUONTriggerLut& rhs)
 void
 AliMUONTriggerLut::ReadFromFile(const char* filename)
 {
+// return output of LuT for corresponding TH3S  
   TFile f(filename);
   
   if ( f.IsZombie() )
index 84412d1..12349e0 100644 (file)
@@ -46,6 +46,7 @@ AliMUONTriggerTrack::AliMUONTriggerTrack()
 AliMUONTriggerTrack::AliMUONTriggerTrack(Float_t x11, Float_t y11, Float_t thetax, Float_t thetay, Long_t theGTPattern)
   : TObject()
 {
+// ctor from local trigger output
     fx11 = x11;
     fy11 = y11;
     fthetax = thetax;