Back to home page

EIC code displayed by LXR

 
 

    


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

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