Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // TensorMesonVectorPScalarDecayer.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_TensorMesonVectorPScalarDecayer_H
0010 #define HERWIG_TensorMesonVectorPScalarDecayer_H
0011 //
0012 // This is the declaration of the TensorMesonVectorPScalarDecayer 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>TensorMesonVectorPScalarDecayer</code> class handles the decay of
0024  *  a tensor meson to a vector and a pseudoscalar. Examples of this decay
0025  *  are \f$a_2\to\rho\pi\f$ or \f$a_2 \to\pi \gamma\f$. The matrix element is
0026  *  given by
0027  *  \f[\mathcal{M}=\epsilon_T^{\mu\nu}p_{P,\mu} \epsilon_{\nu\alpha\beta\gamma}
0028  *     p_V^\alpha \epsilon_V^\beta p_P^\gamma,\f]
0029  * where \f$p_P\f$ is the momentum of the pseudoscalar meson, \f$p_V\f$ is
0030  * the momentum of the vector, \f$\epsilon_T\f$ is the polarization tensor of the 
0031  * decaying meson and \f$\epsilon_V\f$ is the polarization vector of the outgoing
0032  * vector meson.
0033  *
0034  *  The incoming tensor 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 TensorMesonVectorPScalarDecayerInterfaces "The interfaces"
0041  * defined for TensorMesonVectorPScalarDecayer.
0042  */
0043 class TensorMesonVectorPScalarDecayer: public DecayIntegrator {
0044 
0045 public:
0046 
0047   /**
0048    * Which of the possible decays is required
0049    * @param cc Is this mode the charge conjugate
0050    * @param parent The decaying particle
0051    * @param children The decay products
0052    */
0053   virtual int modeNumber(bool & cc, tcPDPtr parent, 
0054              const tPDVector & children) const;
0055 
0056   /**
0057    * Return the matrix element squared for a given mode and phase-space channel.
0058    * @param ichan The channel we are calculating the matrix element for. 
0059    * @param part The decaying Particle.
0060    * @param outgoing The particles produced in the decay
0061    * @param momenta  The momenta of the particles produced in the decay
0062    * @param meopt Option for the calculation of the matrix element
0063    * @return The matrix element squared for the phase-space configuration.
0064    */
0065   double me2(const int ichan,const Particle & part,
0066          const tPDVector & outgoing,
0067          const vector<Lorentz5Momentum> & momenta,
0068          MEOption meopt) const;
0069 
0070   /**
0071    *   Construct the SpinInfos for the particles produced in the decay
0072    */
0073   virtual void constructSpinInfo(const Particle & part,
0074                  ParticleVector outgoing) const;
0075 
0076   /**
0077    * Specify the \f$1\to2\f$ matrix element to be used in the running width calculation.
0078    * @param dm The DecayMode
0079    * @param mecode The code for the matrix element as described
0080    *               in the GenericWidthGenerator class, in this case 8.
0081    * @param coupling The coupling for the matrix element.
0082    * @return True or False if this mode can be handled.
0083    */
0084   bool twoBodyMEcode(const DecayMode & dm, int & mecode, double & coupling) const;
0085 
0086   /**
0087    * Output the setup information for the particle database
0088    * @param os The stream to output the information to
0089    * @param header Whether or not to output the information for MySQL
0090    */
0091   virtual void dataBaseOutput(ofstream & os,bool header) const;
0092 
0093 public:
0094 
0095   /** @name Functions used by the persistent I/O system. */
0096   //@{
0097   /**
0098    * Function used to write out object persistently.
0099    * @param os the persistent output stream written to.
0100    */
0101   void persistentOutput(PersistentOStream & os) const;
0102 
0103   /**
0104    * Function used to read in object persistently.
0105    * @param is the persistent input stream read from.
0106    * @param version the version number of the object when written.
0107    */
0108   void persistentInput(PersistentIStream & is, int version);
0109   //@}
0110 
0111   /**
0112    * Standard Init function used to initialize the interfaces.
0113    */
0114   static void Init();
0115 
0116 protected:
0117 
0118   /** @name Clone Methods. */
0119   //@{
0120   /**
0121    * Make a simple clone of this object.
0122    * @return a pointer to the new object.
0123    */
0124   virtual IBPtr clone() const {return new_ptr(*this);}
0125 
0126   /** Make a clone of this object, possibly modifying the cloned object
0127    * to make it sane.
0128    * @return a pointer to the new object.
0129    */
0130   virtual IBPtr fullclone() const {return new_ptr(*this);}
0131   //@}
0132   
0133 protected:
0134   
0135   /** @name Standard Interfaced functions. */
0136   //@{
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   TensorMesonVectorPScalarDecayer & operator=(const TensorMesonVectorPScalarDecayer &) = 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    * PDG codes for the incoming particles
0169    */
0170   vector<int> incoming_;
0171 
0172   /**
0173    * PDG codes for the outgoing particles (vector,pseudoscalar)
0174    */
0175   vector<pair<int,int> > outgoing_;
0176 
0177   /**
0178    * coupling for the decay
0179    */
0180   vector<InvEnergy2> coupling_;
0181 
0182   /**
0183    * max weight ofr 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_;
0197 
0198   /**
0199    *   Storage of the \f$\rho\f$ matrix
0200    */
0201   mutable RhoDMatrix rho_;
0202 };
0203 
0204 }
0205 
0206 
0207 #endif /* HERWIG_TensorMesonVectorPScalarDecayer_H */