Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // Spin3MesonTensorPScalarDecayer.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_Spin3MesonTensorPScalarDecayer_H
0010 #define HERWIG_Spin3MesonTensorPScalarDecayer_H
0011 //
0012 // This is the declaration of the Spin3MesonTensorPScalarDecayer 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>Spin3MesonTensorPScalarDecayer</code> class is designed for the decay
0024  *  of a rank 3 tensor meson to a tensor and a scalar 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} \epsilon_{\mu\nu\alpha_1\beta_1}(g_{\alpha_2\beta_2} - \frac{p_{1\alpha_2}p_{0\beta_2}}{p_0\cdot p_1-m_0m_1})P_{-\mu}p_{1\nu}(p_1-p_2)_\alpha_3\f]
0026  *  where \f$\epsilon^{\mu\nu\rho}\f$ is the polarization tensor of the decaying 
0027  *  meson, $p_{1,2}$ are the momenta of the decay products and \f$g\f$ is the coupling.
0028  *
0029  * In practice the decay \f$3^-\to1^-)^+\f$ has not been observed but the matrix element also
0030  * applies for the decay \f$3^-\to1^+)^-\f$ which has been observed.
0031  *
0032  *  The incoming tensor mesons together with their decay products and the coupling 
0033  *  \f$g\f$ can be specified using the interfaces for the class. The maximum weights
0034  *  for the decays can be calculated using the Initialize interface of the
0035  *  DecayIntegrator class or specified using the interface.
0036  *
0037  * @see DecayIntegrator
0038  *
0039  * @see \ref Spin3MesonTensorPScalarDecayerInterfaces "The interfaces"
0040  * defined for Spin3MesonTensorPScalarDecayer.
0041  * 
0042  */
0043 class Spin3MesonTensorPScalarDecayer: 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 7.
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    * 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   Spin3MesonTensorPScalarDecayer & operator=(const Spin3MesonTensorPScalarDecayer &) = 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    * the PDG codes for the incoming particles
0168    */
0169   vector<int> incoming_;
0170 
0171   /**
0172    * the PDG codes the outgoing particles (vector,scalar)
0173    */
0174   vector<pair<long,long> > outgoing_;
0175 
0176   /**
0177    * the coupling for the decay
0178    */
0179   vector<InvEnergy2> coupling_;
0180 
0181   /**
0182    * the maximum weight for the decay
0183    */
0184   vector<double> maxWeight_;
0185 
0186   /**
0187    *  Storage of polarization tensors to try and increase
0188    *  speed
0189    */
0190   mutable vector<Helicity::LorentzRank3Tensor<double> > rank3_;
0191 
0192   /**
0193    *  Polarization tensors for the decay product
0194    */
0195   mutable vector<Helicity::LorentzTensor<double> > tensors_;
0196 
0197   /**
0198    *   Storage of the \f$\rho\f$ matrix
0199    */
0200   mutable RhoDMatrix rho_;
0201 
0202 };
0203 
0204 }
0205 
0206 #endif /* HERWIG_Spin3MesonTensorPScalarDecayer_H */