Back to home page

EIC code displayed by LXR

 
 

    


File indexing completed on 2026-08-06 09:24:03

0001 // -*- C++ -*-
0002 //
0003 // VectorMeson2MesonDecayer.h is a part of Herwig - A multi-purpose Monte Carlo event generator
0004 // Copyright (C) 2002-2019 The Herwig Collaboration
0005 //
0006 // Herwig is licenced under version 3 of the GPL, see COPYING for details.
0007 // Please respect the MCnet academic guidelines, see GUIDELINES for details.
0008 //
0009 #ifndef HERWIG_VectorMeson2MesonDecayer_H
0010 #define HERWIG_VectorMeson2MesonDecayer_H
0011 //
0012 // This is the declaration of the VectorMeson2MesonDecayer class.
0013 //
0014 #include "Herwig/Decay/DecayIntegrator.h"
0015 #include "Herwig/Decay/PhaseSpaceMode.h"
0016 #include "ThePEG/Helicity/LorentzPolarizationVector.h"
0017 
0018 namespace Herwig {
0019 
0020 using namespace ThePEG;
0021 
0022 /** \ingroup Decay
0023  *
0024  *  This class is the implementation for the decay of a vector meson to 
0025  *  two scalar mesons, the classic example is \f$\rho -> \pi\pi\f$, via a current
0026  *  which is the difference of the momenta of the mesons.
0027  *  \f[\mathcal{M} = g\epsilon_\mu(p_1-p_2)^\mu,\f]
0028  *  where \f$p_{1,2}\f$ are the momenta of the decay products,
0029  *  \f$\epsilon\f$ is the polarization vector of the decaying particle
0030  *  and \f$g\f$ the coupling.
0031  *  Obviously the
0032  *  order of the momenta doesn't matter as it will only effect the sign of the
0033  *  matrix element.
0034  *
0035  *  The incoming vector mesons together with their decay products and the coupling 
0036  *  \f$g\f$ can be specified using the interfaces for the class. The maximum weights
0037  *  for the decays can be calculated using the Initialize interface of the
0038  *  DecayIntegrator class or specified using the interface.
0039  *
0040  *  The incoming and outgoing particles, couplings and maximum weights for
0041  *  many of the common \f$V\to PP\f$ decays are specified in the default
0042  *  constructor.
0043  *
0044  * @see DecayIntegrator
0045  * @see \ref VectorMeson2MesonDecayerInterfaces "The interfaces"
0046  * defined for VectorMeson2MesonDecayer.
0047  * 
0048  *  \author Peter Richardson
0049  *
0050  */
0051 class VectorMeson2MesonDecayer: public DecayIntegrator {
0052   
0053 public:
0054 
0055   /**
0056    * Default constructor.
0057    */
0058   VectorMeson2MesonDecayer();
0059 
0060   /**
0061    * Which of the possible decays is required
0062    * @param cc Is this mode the charge conjugate
0063    * @param parent The decaying particle
0064    * @param children The decay products
0065    */
0066   virtual int modeNumber(bool & cc, tcPDPtr parent, 
0067              const tPDVector & children) const;
0068 
0069   /**
0070    * Return the matrix element squared for a given mode and phase-space channel.
0071    * @param ichan The channel we are calculating the matrix element for. 
0072    * @param part The decaying Particle.
0073    * @param outgoing The particles produced in the decay
0074    * @param momenta  The momenta of the particles produced in the decay
0075    * @param meopt Option for the calculation of the matrix element
0076    * @return The matrix element squared for the phase-space configuration.
0077    */
0078   double me2(const int ichan,const Particle & part,
0079          const tPDVector & outgoing,
0080          const vector<Lorentz5Momentum> & momenta,
0081          MEOption meopt) const;
0082 
0083   /**
0084    *   Construct the SpinInfos for the particles produced in the decay
0085    */
0086   virtual void constructSpinInfo(const Particle & part,
0087                  ParticleVector outgoing) const;
0088 
0089   /**
0090    * Specify the \f$1\to2\f$ matrix element to be used in the running width calculation.
0091    * @param dm The DecayMode
0092    * @param mecode The code for the matrix element as described
0093    *               in the GenericWidthGenerator class, in this case 0.
0094    * @param coupling The coupling for the matrix element.
0095    * @return True or False if this mode can be handled.
0096    */
0097   bool twoBodyMEcode(const DecayMode & dm, int & mecode, double & coupling) const;
0098 
0099   /**
0100    * Output the setup information for the particle database
0101    * @param os The stream to output the information to
0102    * @param header Whether or not to output the information for MySQL
0103    */
0104   virtual void dataBaseOutput(ofstream & os,bool header) const;
0105 
0106 public:
0107   
0108   /** @name Functions used by the persistent I/O system. */
0109   //@{
0110   /**
0111    * Function used to write out object persistently.
0112    * @param os the persistent output stream written to.
0113    */
0114   void persistentOutput(PersistentOStream & os) const;
0115 
0116   /**
0117    * Function used to read in object persistently.
0118    * @param is the persistent input stream read from.
0119    * @param version the version number of the object when written.
0120    */
0121   void persistentInput(PersistentIStream & is, int version);
0122   //@}
0123   
0124   /**
0125    * Standard Init function used to initialize the interfaces.
0126    */
0127   static void Init();
0128   
0129 protected:
0130   
0131   /** @name Clone Methods. */
0132   //@{
0133   /**
0134    * Make a simple clone of this object.
0135    * @return a pointer to the new object.
0136    */
0137   virtual IBPtr clone() const { return new_ptr(*this);}
0138 
0139   /** Make a clone of this object, possibly modifying the cloned object
0140    * to make it sane.
0141    * @return a pointer to the new object.
0142    */
0143   virtual IBPtr fullclone() const { return new_ptr(*this);}
0144   //@}
0145   
0146 protected:
0147   
0148   /** @name Standard Interfaced functions. */
0149   //@{
0150   /**
0151    * Initialize this object after the setup phase before saving and
0152    * EventGenerator to disk.
0153    * @throws InitException if object could not be initialized properly.
0154    */
0155   virtual void doinit();
0156 
0157   /**
0158    * Initialize this object to the begining of the run phase.
0159    */
0160   virtual void doinitrun();
0161   //@}
0162 
0163 private:
0164   
0165   /**
0166    * Private and non-existent assignment operator.
0167    */
0168   VectorMeson2MesonDecayer & operator=(const VectorMeson2MesonDecayer &) = delete;
0169 
0170 public:
0171 
0172   /**
0173    *   Set the parameters for a decay mode
0174    */
0175   string setUpDecayMode(string arg);
0176   
0177 private:
0178   
0179 
0180   /**
0181    * the PDG codes for the incoming particles
0182    */
0183   vector<long> incoming_;
0184 
0185   /**
0186    * The PDG codes for the outgoing mesons
0187    */
0188   vector<pair<long,long> > outgoing_;
0189 
0190   /**
0191    * the maximum weight for the integration
0192    */
0193   vector<double> maxWeight_;
0194 
0195   /**
0196    * the coupling for the decay
0197    */
0198   vector<double> coupling_;
0199 
0200   /**
0201    *  Storage of polarization tensors to try and increase
0202    *  speed
0203    */
0204   mutable vector<Helicity::LorentzPolarizationVector> vectors_;
0205   
0206   /**
0207    *   Storage of the \f$\rho\f$ matrix
0208    */
0209   mutable RhoDMatrix rho_;
0210 };
0211   
0212 }
0213 
0214 
0215 #endif /* HERWIG_VectorMeson2MesonDecayer_H */