ROOT logo
// @(#)root/eg:$Id: TParticle.h 31515 2009-12-03 08:36:59Z brun $
// Author: Rene Brun , Federico Carminati  26/04/99

/*************************************************************************
 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
//////////////////////////////////////////////////////////////////////////
//                                                                      //
// TParticle: defines  equivalent of HEPEVT particle                    //
//////////////////////////////////////////////////////////////////////////

#ifndef ROOT_TParticle
#define ROOT_TParticle

#ifndef ROOT_TNamed
#include "TNamed.h"
#endif
#ifndef ROOT_TAttLine
#include "TAttLine.h"
#endif
#ifndef ROOT_TAtt3D
#include "TAtt3D.h"
#endif
#ifndef ROOT_TLorentzVector
#include "TLorentzVector.h"
#endif

class TParticlePDG;

class TParticle : public TObject, public TAttLine, public TAtt3D {


protected:

  Int_t          fPdgCode;              // PDG code of the particle
  Int_t          fStatusCode;           // generation status code
  Int_t          fMother[2];            // Indices of the mother particles
  Int_t          fDaughter[2];          // Indices of the daughter particles
  Float_t        fWeight;               // particle weight

  Double_t       fCalcMass;             // Calculated mass

  Double_t       fPx;                   // x component of momentum
  Double_t       fPy;                   // y component of momentum
  Double_t       fPz;                   // z component of momentum
  Double_t       fE;                    // Energy

  Double_t       fVx;                   // x of production vertex
  Double_t       fVy;                   // y of production vertex
  Double_t       fVz;                   // z of production vertex
  Double_t       fVt;                   // t of production vertex

  Double_t       fPolarTheta;           // Polar angle of polarisation
  Double_t       fPolarPhi;             // azymutal angle of polarisation

  TParticlePDG*  fParticlePDG;          //! reference to the particle record in PDG database
  //the line above should be changed to the following line when all compilers
  //will be able to digest the mutable keyword (We want to have GetPDG const !!)
  //mutable TParticlePDG*  fParticlePDG;  //! reference to the particle record in PDG database
  //----------------------------------------------------------------------------
  //  functions
  //----------------------------------------------------------------------------
public:
                                // ****** constructors and destructor
   TParticle();

   TParticle(Int_t pdg, Int_t status,
             Int_t mother1, Int_t mother2,
             Int_t daughter1, Int_t daughter2,
             Double_t px, Double_t py, Double_t pz, Double_t etot,
             Double_t vx, Double_t vy, Double_t vz, Double_t time);

   TParticle(Int_t pdg, Int_t status,
             Int_t mother1, Int_t mother2,
             Int_t daughter1, Int_t daughter2,
             const TLorentzVector &p,
             const TLorentzVector &v);

   TParticle(const TParticle &part);

   virtual ~TParticle();

   TParticle& operator=(const TParticle&);

//   virtual TString* Name   () const { return fName.Data(); }
//   virtual char*  GetName()   const { return fName.Data(); }

   Int_t          GetStatusCode   ()            const { return fStatusCode;                                     }
   Int_t          GetPdgCode      ()            const { return fPdgCode;                                        }
   Int_t          GetFirstMother  ()            const { return fMother[0];                                      }
   Int_t          GetMother       (Int_t i)     const { return fMother[i];                                      }
   Int_t          GetSecondMother ()            const { return fMother[1];                                      }
   Bool_t         IsPrimary       ()            const { return fMother[0]>-1 ? kFALSE : kTRUE;                  } //Is this particle primary one?
   Int_t          GetFirstDaughter()            const { return fDaughter[0];                                    }
   Int_t          GetDaughter     (Int_t i)     const { return fDaughter[i];                                    }
   Int_t          GetLastDaughter ()            const { return fDaughter[1];                                    }
   Double_t       GetCalcMass     ()            const { return fCalcMass;                                       }
   Double_t       GetMass         ();
   Int_t          GetNDaughters   ()            const { return fDaughter[1]>0 ? fDaughter[1]-fDaughter[0]+1 : 0;}
   Float_t        GetWeight       ()            const { return fWeight;                                         }
   void           GetPolarisation(TVector3 &v);
   TParticlePDG*  GetPDG          (Int_t mode = 0);
   Int_t          Beauty          ();
   Int_t          Charm           ();
   Int_t          Strangeness     ();
   void           Momentum(TLorentzVector &v)   const { v.SetPxPyPzE(fPx,fPy,fPz,fE);                           }
   void           ProductionVertex(TLorentzVector &v) const { v.SetXYZT(fVx,fVy,fVz,fVt);                       }

// ****** redefine several most oftenly used methods of LORENTZ_VECTOR

   Double_t       Vx              ()            const { return fVx;                                             }
   Double_t       Vy              ()            const { return fVy;                                             }
   Double_t       Vz              ()            const { return fVz;                                             }
   Double_t       T               ()            const { return fVt;                                             }
   Double_t       R               ()            const { return TMath::Sqrt(fVx*fVx+fVy*fVy);                    } //Radius of production vertex in cylindrical system
   Double_t       Rho             ()            const { return TMath::Sqrt(fVx*fVx+fVy*fVy+fVz*fVz);            } //Radius of production vertex in spherical system
   Double_t       Px              ()            const { return fPx;                                             }
   Double_t       Py              ()            const { return fPy;                                             }
   Double_t       Pz              ()            const { return fPz;                                             }
   Double_t       P               ()            const { return TMath::Sqrt(fPx*fPx+fPy*fPy+fPz*fPz);            }
   Double_t       Pt              ()            const { return TMath::Sqrt(fPx*fPx+fPy*fPy);                    }
   Double_t       Energy          ()            const { return fE;                                              }
   Double_t       Eta             ()            const
   {
      Double_t pmom = P();
      if (pmom != TMath::Abs(fPz)) return 0.5*TMath::Log((pmom+fPz)/(pmom-fPz));
      else                         return 1.e30;
   }
   Double_t       Y               ()            const
   {
      if (fE != TMath::Abs(fPz))   return 0.5*TMath::Log((fE+fPz)/(fE-fPz));
      else                         return 1.e30;
   }

   Double_t         Phi   () const { return TMath::Pi()+TMath::ATan2(-fPy,-fPx); }  // note that Phi() returns an angle between 0 and 2pi
   Double_t         Theta () const { return (fPz==0)?TMath::PiOver2():TMath::ACos(fPz/P()); }

              // setters

   void           SetFirstMother  (int code)                                               { fMother[0]   = code ; }
   void           SetMother  (int i, int code)                                             { fMother[i]   = code ; }
   void           SetLastMother  (int code)                                                { fMother[1]   = code ; }
   void           SetFirstDaughter(int code)                                               { fDaughter[0] = code ; }
   void           SetDaughter(int i, int code)                                             { fDaughter[i] = code ; }
   void           SetLastDaughter(int code)                                                { fDaughter[1] = code ; }
   void           SetCalcMass(Double_t mass)                                               { fCalcMass=mass;}
   void           SetPdgCode(Int_t pdg);
   void           SetPolarisation(Double_t polx, Double_t poly, Double_t polz);
   void           SetPolarisation(const TVector3& v)                                       {SetPolarisation(v.X(), v.Y(), v.Z());}
   void           SetStatusCode(int status)                                                {fStatusCode = status;}
   void           SetWeight(Float_t weight = 1)                                            {fWeight = weight; }
   void           SetMomentum(Double_t px, Double_t py, Double_t pz, Double_t e)           {fPx=px; fPy=py; fPz=pz; fE=e;}
   void           SetMomentum(const TLorentzVector& p)                                     {SetMomentum(p.Px(),p.Py(),p.Pz(),p.Energy());}
   void           SetProductionVertex(Double_t vx, Double_t vy, Double_t vz, Double_t t)   {fVx=vx; fVy=vy; fVz=vz; fVt=t;}
   void           SetProductionVertex(const TLorentzVector& v)                             {SetProductionVertex(v.X(),v.Y(),v.Z(),v.T());}

             // ****** overloaded functions of TObject

   virtual void      Paint(Option_t *option = "");
   virtual void      Print(Option_t *option = "") const;
   virtual void      Sizeof3D() const;
   virtual Int_t     DistancetoPrimitive(Int_t px, Int_t py);
   virtual void      ExecuteEvent(Int_t event, Int_t px, Int_t py);
   virtual const     char *GetName() const;
   virtual const     char *GetTitle() const;


   ClassDef(TParticle,2)  // TParticle vertex particle information
};

#endif
 TParticle.h:1
 TParticle.h:2
 TParticle.h:3
 TParticle.h:4
 TParticle.h:5
 TParticle.h:6
 TParticle.h:7
 TParticle.h:8
 TParticle.h:9
 TParticle.h:10
 TParticle.h:11
 TParticle.h:12
 TParticle.h:13
 TParticle.h:14
 TParticle.h:15
 TParticle.h:16
 TParticle.h:17
 TParticle.h:18
 TParticle.h:19
 TParticle.h:20
 TParticle.h:21
 TParticle.h:22
 TParticle.h:23
 TParticle.h:24
 TParticle.h:25
 TParticle.h:26
 TParticle.h:27
 TParticle.h:28
 TParticle.h:29
 TParticle.h:30
 TParticle.h:31
 TParticle.h:32
 TParticle.h:33
 TParticle.h:34
 TParticle.h:35
 TParticle.h:36
 TParticle.h:37
 TParticle.h:38
 TParticle.h:39
 TParticle.h:40
 TParticle.h:41
 TParticle.h:42
 TParticle.h:43
 TParticle.h:44
 TParticle.h:45
 TParticle.h:46
 TParticle.h:47
 TParticle.h:48
 TParticle.h:49
 TParticle.h:50
 TParticle.h:51
 TParticle.h:52
 TParticle.h:53
 TParticle.h:54
 TParticle.h:55
 TParticle.h:56
 TParticle.h:57
 TParticle.h:58
 TParticle.h:59
 TParticle.h:60
 TParticle.h:61
 TParticle.h:62
 TParticle.h:63
 TParticle.h:64
 TParticle.h:65
 TParticle.h:66
 TParticle.h:67
 TParticle.h:68
 TParticle.h:69
 TParticle.h:70
 TParticle.h:71
 TParticle.h:72
 TParticle.h:73
 TParticle.h:74
 TParticle.h:75
 TParticle.h:76
 TParticle.h:77
 TParticle.h:78
 TParticle.h:79
 TParticle.h:80
 TParticle.h:81
 TParticle.h:82
 TParticle.h:83
 TParticle.h:84
 TParticle.h:85
 TParticle.h:86
 TParticle.h:87
 TParticle.h:88
 TParticle.h:89
 TParticle.h:90
 TParticle.h:91
 TParticle.h:92
 TParticle.h:93
 TParticle.h:94
 TParticle.h:95
 TParticle.h:96
 TParticle.h:97
 TParticle.h:98
 TParticle.h:99
 TParticle.h:100
 TParticle.h:101
 TParticle.h:102
 TParticle.h:103
 TParticle.h:104
 TParticle.h:105
 TParticle.h:106
 TParticle.h:107
 TParticle.h:108
 TParticle.h:109
 TParticle.h:110
 TParticle.h:111
 TParticle.h:112
 TParticle.h:113
 TParticle.h:114
 TParticle.h:115
 TParticle.h:116
 TParticle.h:117
 TParticle.h:118
 TParticle.h:119
 TParticle.h:120
 TParticle.h:121
 TParticle.h:122
 TParticle.h:123
 TParticle.h:124
 TParticle.h:125
 TParticle.h:126
 TParticle.h:127
 TParticle.h:128
 TParticle.h:129
 TParticle.h:130
 TParticle.h:131
 TParticle.h:132
 TParticle.h:133
 TParticle.h:134
 TParticle.h:135
 TParticle.h:136
 TParticle.h:137
 TParticle.h:138
 TParticle.h:139
 TParticle.h:140
 TParticle.h:141
 TParticle.h:142
 TParticle.h:143
 TParticle.h:144
 TParticle.h:145
 TParticle.h:146
 TParticle.h:147
 TParticle.h:148
 TParticle.h:149
 TParticle.h:150
 TParticle.h:151
 TParticle.h:152
 TParticle.h:153
 TParticle.h:154
 TParticle.h:155
 TParticle.h:156
 TParticle.h:157
 TParticle.h:158
 TParticle.h:159
 TParticle.h:160
 TParticle.h:161
 TParticle.h:162
 TParticle.h:163
 TParticle.h:164
 TParticle.h:165
 TParticle.h:166
 TParticle.h:167
 TParticle.h:168
 TParticle.h:169
 TParticle.h:170
 TParticle.h:171
 TParticle.h:172
 TParticle.h:173
 TParticle.h:174
 TParticle.h:175