Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // Spin3Meson2PScalarDecayer.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_Spin3Meson2PScalarDecayer_H
0010 #define HERWIG_Spin3Meson2PScalarDecayer_H
0011 //
0012 // This is the declaration of the Spin3Meson2PScalarDecayer class.
0013 //
0014 #include "Herwig/Decay/DecayIntegrator.h"
0015 #include "Herwig/Decay/PhaseSpaceMode.h"
0016 
0017 namespace Herwig {
0018 using namespace ThePEG;
0019 
0020 /** \ingroup Decay
0021  *
0022  *  The <code>Spin3Meson2PScalarDecayer</code> class is designed for the decay
0023  *  of a rank 3 tensor meson to two pseudoscalars via matrix element which takes the form
0024  *  \f[ \mathcal{M} =  g \epsilon^{\mu\nu\rho} (p_1-p_2)_\mu (p_1-p_2)_\nu (p_1-p_2)_\rho \f]
0025  *  where \f$\epsilon^{\mu\nu\rho}\f$ is the polarization tensor of the decaying 
0026  *  meson, $p_{1,2}$ are the momenta of the decay products and \f$g\f$ is the coupling.
0027  *
0028  *  It can also be used for the decay of a rank 3 tensor to two scalar mesons although
0029  *  this rarely happens in practice.
0030  *
0031  *  The incoming tensor mesons together with their decay products and the coupling 
0032  *  \f$g\f$ can be specified using the interfaces for the class. The maximum weights
0033  *  for the decays can be calculated using the Initialize interface of the
0034  *  DecayIntegrator class or specified using the interface.
0035  *
0036  * @see DecayIntegrator
0037  *
0038  * @see \ref Spin3Meson2PScalarDecayerInterfaces "The interfaces"
0039  * defined for Spin3Meson2PScalarDecayer.
0040  * 
0041  */
0042 class Spin3Meson2PScalarDecayer: 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 7.
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    * Initialize this object after the setup phase before saving and
0138    * EventGenerator to disk.
0139    * @throws InitException if object could not be initialized properly.
0140    */
0141   virtual void doinit();
0142 
0143   /**
0144    * Initialize this object to the begining of the run phase.
0145    */
0146   virtual void doinitrun();
0147   //@}
0148 
0149 private:
0150 
0151   /**
0152    * Private and non-existent assignment operator.
0153    */
0154   Spin3Meson2PScalarDecayer & operator=(const Spin3Meson2PScalarDecayer &) = delete;
0155   
0156 public:
0157 
0158   /**
0159    *   Set the parameters for a decay mode
0160    */
0161   string setUpDecayMode(string arg);
0162 
0163 private:
0164 
0165   /**
0166    * the PDG codes for the incoming particles
0167    */
0168   vector<int> incoming_;
0169 
0170   /**
0171    * the PDG codes the outgoing particles
0172    */
0173   vector<pair<long,long> > outgoing_;
0174 
0175   /**
0176    * the coupling for the decay
0177    */
0178   vector<InvEnergy2> coupling_;
0179 
0180   /**
0181    * the maximum weight for the decay
0182    */
0183   vector<double> maxWeight_;
0184 
0185   /**
0186    *  Storage of polarization tensors to try and increase
0187    *  speed
0188    */
0189   mutable vector<Helicity::LorentzRank3Tensor<double> > tensors_;
0190 
0191   /**
0192    *   Storage of the \f$\rho\f$ matrix
0193    */
0194   mutable RhoDMatrix rho_;
0195 
0196 };
0197 
0198 }
0199 
0200 #endif /* HERWIG_Spin3Meson2PScalarDecayer_H */