Back to home page

EIC code displayed by LXR

 
 

    


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

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