Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // TensorMesonVectorScalarDecayer.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_TensorMesonVectorScalarDecayer_H
0010 #define HERWIG_TensorMesonVectorScalarDecayer_H
0011 //
0012 // This is the declaration of the TensorMesonVectorScalarDecayer class.
0013 //
0014 #include "Herwig/Decay/DecayIntegrator.h"
0015 #include "ThePEG/Helicity/LorentzPolarizationVector.h"
0016 #include "Herwig/Decay/PhaseSpaceMode.h"
0017 
0018 namespace Herwig {
0019 using namespace ThePEG;
0020 
0021 /** \ingroup Decay
0022  *
0023  *  The <code>TensorMesonVectorScalarDecayer</code> class handles the decay of
0024  *  a tensor meson to vector and a scalar meson. In reality all the decays
0025  *  handled by this class are for a pseudotensor meson to a vector and a pseudoscalar meson,
0026  *  which has the same structure. The matrix element is
0027  *  given by \f[\mathcal{M}=\epsilon_0^{\alpha_1\alpha_2} \epsilon_1^{\beta} 
0028  *  \left(g_{\alpha_1\beta}+\frac{p_{1\alpha_1}p_{0\beta}{p_0\cdot p_1-m_0m_1}\right)(p_1-p2)_{\alpha_2}\f]
0029  *  where \f$p_{0,1,2}\f$ are the momenta of the incoming and outgoing tensor vector and scalar mesons, respectively,
0030  * and \f$\epsilon_{0}\f$ is the polarization tensors of the incoming tensor meson and $\epslion_1$ that of the outgoing
0031  * vector meson.
0032  *
0033  *  The incoming tensor mesons together with their decay products and the coupling 
0034  *  \f$g\f$ can be specified using the interfaces for the class. The maximum weights
0035  *  for the decays can be calculated using the Initialize interface of the
0036  *  DecayIntegrator class or specified using the interface.
0037  *
0038  * @see DecayIntegrator
0039  * @see \ref TensorMesonVectorScalarDecayerInterfaces "The interfaces"
0040  * defined for TensorMesonVectorScalarDecayer.
0041  */
0042 class TensorMesonVectorScalarDecayer: public DecayIntegrator {
0043 
0044 public:
0045 
0046   /**
0047    * Which of the possible decays is required
0048    * @param cc Is this mode the charge conjugate
0049    * @param parent The decaying particle
0050    * @param children The decay products
0051    */
0052   virtual int modeNumber(bool & cc, tcPDPtr parent, 
0053              const tPDVector & children) const;
0054 
0055   /**
0056    * Return the matrix element squared for a given mode and phase-space channel.
0057    * @param ichan The channel we are calculating the matrix element for. 
0058    * @param part The decaying Particle.
0059    * @param outgoing The particles produced in the decay
0060    * @param momenta  The momenta of the particles produced in the decay
0061    * @param meopt Option for the calculation of the matrix element
0062    * @return The matrix element squared for the phase-space configuration.
0063    */
0064   double me2(const int ichan,const Particle & part,
0065          const tPDVector & outgoing,
0066          const vector<Lorentz5Momentum> & momenta,
0067          MEOption meopt) const;
0068 
0069   /**
0070    *   Construct the SpinInfos for the particles produced in the decay
0071    */
0072   virtual void constructSpinInfo(const Particle & part,
0073                  ParticleVector outgoing) const;
0074 
0075   /**
0076    * Specify the \f$1\to2\f$ matrix element to be used in the running width calculation.
0077    * @param dm The DecayMode
0078    * @param mecode The code for the matrix element as described
0079    *               in the GenericWidthGenerator class, in this case 8.
0080    * @param coupling The coupling for the matrix element.
0081    * @return True or False if this mode can be handled.
0082    */
0083   bool twoBodyMEcode(const DecayMode & dm, int & mecode, double & coupling) const;
0084 
0085   /**
0086    * Output the setup information for the particle database
0087    * @param os The stream to output the information to
0088    * @param header Whether or not to output the information for MySQL
0089    */
0090   virtual void dataBaseOutput(ofstream & os,bool header) const;
0091 
0092 public:
0093 
0094   /** @name Functions used by the persistent I/O system. */
0095   //@{
0096   /**
0097    * Function used to write out object persistently.
0098    * @param os the persistent output stream written to.
0099    */
0100   void persistentOutput(PersistentOStream & os) const;
0101 
0102   /**
0103    * Function used to read in object persistently.
0104    * @param is the persistent input stream read from.
0105    * @param version the version number of the object when written.
0106    */
0107   void persistentInput(PersistentIStream & is, int version);
0108   //@}
0109 
0110   /**
0111    * Standard Init function used to initialize the interfaces.
0112    */
0113   static void Init();
0114 
0115 protected:
0116 
0117   /** @name Clone Methods. */
0118   //@{
0119   /**
0120    * Make a simple clone of this object.
0121    * @return a pointer to the new object.
0122    */
0123   virtual IBPtr clone() const {return new_ptr(*this);}
0124 
0125   /** Make a clone of this object, possibly modifying the cloned object
0126    * to make it sane.
0127    * @return a pointer to the new object.
0128    */
0129   virtual IBPtr fullclone() const {return new_ptr(*this);}
0130   //@}
0131   
0132 protected:
0133   
0134   /** @name Standard Interfaced functions. */
0135   //@{
0136 
0137   /**
0138    * Initialize this object after the setup phase before saving and
0139    * EventGenerator to disk.
0140    * @throws InitException if object could not be initialized properly.
0141    */
0142   virtual void doinit();
0143 
0144   /**
0145    * Initialize this object to the begining of the run phase.
0146    */
0147   virtual void doinitrun();
0148   //@}
0149 
0150 private:
0151 
0152   /**
0153    * Private and non-existent assignment operator.
0154    */
0155   TensorMesonVectorScalarDecayer & operator=(const TensorMesonVectorScalarDecayer &) = delete;
0156 
0157 public:
0158 
0159   /**
0160    *   Set the parameters for a decay mode
0161    */
0162   string setUpDecayMode(string arg);
0163 
0164 private:
0165 
0166   /**
0167    * PDG codes for the incoming particles
0168    */
0169   vector<int> incoming_;
0170 
0171   /**
0172    * PDG codes for the outgoing particles (tensor,scalar)
0173    */
0174   vector<pair<int,int> > outgoing_;
0175 
0176   /**
0177    * coupling for the decay
0178    */
0179   vector<double> coupling_;
0180 
0181   /**
0182    * max weight ofr the decay
0183    */
0184   vector<double> maxWeight_;
0185 
0186   /**
0187    *  Storage of polarization tensors (incoming) to try and increase
0188    *  speed
0189    */
0190   mutable vector<Helicity::LorentzTensor<double> > tensors_;
0191 
0192   /**
0193    *  Storage of the polarization vectors
0194    */
0195   mutable vector<Helicity::LorentzPolarizationVector> vectors_;
0196 
0197   /**
0198    *   Storage of the \f$\rho\f$ matrix
0199    */
0200   mutable RhoDMatrix rho_;
0201 };
0202 
0203 }
0204 
0205 
0206 #endif /* HERWIG_TensorMesonVectorScalarDecayer_H */