Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // EtaPiPiFermionsDecayer.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_EtaPiPiFermionsDecayer_H
0010 #define HERWIG_EtaPiPiFermionsDecayer_H
0011 // This is the declaration of the EtaPiPiFermionsDecayer class.
0012 
0013 #include "Herwig/Utilities/Kinematics.h"
0014 #include "Herwig/Decay/DecayIntegrator.h"
0015 #include "Herwig/Decay/PhaseSpaceMode.h"
0016 #include "Herwig/Decay/FormFactors/OmnesFunction.fh"
0017 #include "ThePEG/Helicity/LorentzSpinorBar.h"
0018 
0019 namespace Herwig {
0020 using namespace ThePEG;
0021 
0022 /** \ingroup Decay
0023  *
0024  * The <code>EtaPiPiFermionsDecayer</code> class implements the decay of
0025  * the \f$\eta\f$ or \f$\eta'\f$ to \f$\pi^+\pi^-\gamma\f$ using either 
0026  * a VMD type model or a model using either the theoretical or experimental 
0027  * form of the Omnes function taken from hep-ph/0112150.
0028  *
0029  * The matrix element is given by
0030  * \f[\mathcal{M} = B(s_{+-},s_{+\gamma},s_{-\gamma})\epsilon^{\mu\nu\alpha\beta}
0031  *      \epsilon^*_{\mu}p_{+\nu}p_{-\alpha}p_{\gamma\beta}\f]
0032  * where \f$p_{+,-}\f$ are the momenta of the positively and negatively charged pions,
0033  * \f$p_{\gamma}\f$ is the momentum of the photon and \f$s_{ij} = (p_i+p_j)^2\f$.
0034  *
0035  *  The different models take
0036  *
0037  *  \f[B(s_{+-},s_{+\gamma},s_{-\gamma}) = 
0038  *  B_0\left(1+\frac32\frac{s_{+-}}{M^2_\rho-s_{+-}-iM_\rho\Gamma_\rho(s_{+-})}\right)\f]
0039  *  where \f$M_\rho\f$ and \f$\Gamma_\rho\f$ are the mass and running width 
0040  *  of the \f$\rho\f$
0041  *  respectively for the VMD model.
0042  *
0043  *  For the Omnes function case we take
0044  *
0045  *  \f[B(s_{+-},s_{+\gamma},s_{-\gamma}) = 
0046  *  B_0\left(1-c+c\frac{1+as_{+-}}{D_1(s_{+-})}\right)\f]
0047  *  either the experimental or analytic form of the Omnes function \f$D_1(s_{+-})\f$
0048  *  taken from hep-ph/0112150 can be used.
0049  *
0050  *  The coefficient \f$B_0\f$ is given in hep-ph/0112150. We use the values from this
0051  *  paper and use their default choice \f$c=1\f$, \f$a=\frac1{2M_\rho}\f$.
0052  *
0053  * @see DecayIntegrator
0054  * 
0055  */
0056 class EtaPiPiFermionsDecayer: public DecayIntegrator {
0057 
0058 public:
0059 
0060   /**
0061    * Default constructor.
0062    */
0063   EtaPiPiFermionsDecayer();
0064   
0065   /**
0066    * Which of the possible decays is required
0067    * @param cc Is this mode the charge conjugate
0068    * @param parent The decaying particle
0069    * @param children The decay products
0070    */
0071   virtual int modeNumber(bool & cc, tcPDPtr parent, 
0072              const tPDVector & children) const;
0073   
0074   /**
0075    * Return the matrix element squared for a given mode and phase-space channel.
0076    * @param ichan The channel we are calculating the matrix element for. 
0077    * @param part The decaying Particle.
0078    * @param outgoing The particles produced in the decay
0079    * @param momenta  The momenta of the particles produced in the decay
0080    * @param meopt Option for the calculation of the matrix element
0081    * @return The matrix element squared for the phase-space configuration.
0082    */
0083   double me2(const int ichan,const Particle & part,
0084          const tPDVector & outgoing,
0085          const vector<Lorentz5Momentum> & momenta,
0086          MEOption meopt) const;
0087 
0088   /**
0089    *   Construct the SpinInfos for the particles produced in the decay
0090    */
0091   virtual void constructSpinInfo(const Particle & part,
0092                  ParticleVector outgoing) const;
0093 
0094   /**
0095    * Output the setup information for the particle database
0096    * @param os The stream to output the information to
0097    * @param header Whether or not to output the information for MySQL
0098    */
0099   virtual void dataBaseOutput(ofstream & os,bool header) const;
0100 
0101 public:
0102 
0103   /** @name Functions used by the persistent I/O system. */
0104   //@{
0105   /**
0106    * Function used to write out object persistently.
0107    * @param os the persistent output stream written to.
0108    */
0109   void persistentOutput(PersistentOStream & os) const;
0110 
0111   /**
0112    * Function used to read in object persistently.
0113    * @param is the persistent input stream read from.
0114    * @param version the version number of the object when written.
0115    */
0116   void persistentInput(PersistentIStream & is, int version);
0117   //@}
0118 
0119   /**
0120    * Standard Init function used to initialize the interfaces.
0121    */
0122   static void Init();
0123 
0124 protected:
0125 
0126   /** @name Clone Methods. */
0127   //@{
0128   /**
0129    * Make a simple clone of this object.
0130    * @return a pointer to the new object.
0131    */
0132   virtual IBPtr clone() const {return new_ptr(*this);}
0133 
0134   /** Make a clone of this object, possibly modifying the cloned object
0135    * to make it sane.
0136    * @return a pointer to the new object.
0137    */
0138   virtual IBPtr fullclone() const {return new_ptr(*this);}
0139   //@}
0140   
0141 protected:
0142   
0143   /** @name Standard Interfaced functions. */
0144   //@{
0145 
0146   /**
0147    * Initialize this object after the setup phase before saving and
0148    * EventGenerator to disk.
0149    * @throws InitException if object could not be initialized properly.
0150    */
0151   virtual void doinit();
0152 
0153   /**
0154    * Initialize this object to the begining of the run phase.
0155    */
0156   virtual void doinitrun();
0157   //@}
0158 
0159 public:
0160 
0161   /**
0162    *   Set the parameters for a decay mode
0163    */
0164   string setUpDecayMode(string arg);
0165 
0166 private:
0167 
0168   /**
0169    * Private and non-existent assignment operator.
0170    */
0171   EtaPiPiFermionsDecayer & operator=(const EtaPiPiFermionsDecayer &) = delete;
0172 
0173 private:
0174 
0175   /**
0176    * the pion decay constant, \f$F_\pi\f$.
0177    */
0178   Energy fPi_;
0179 
0180   /**
0181    * the PDG code for the incoming particle
0182    */
0183   vector<int> incoming_;
0184 
0185   /**
0186    *  The PDG code of the leptons
0187    */
0188   vector<int> lepton_;
0189 
0190   /**
0191    * Coupling for the decay, \f$B_0\f$.
0192    */
0193   vector<double> coupling_;
0194 
0195   /**
0196    * The maximum weight
0197    */
0198   vector<double> maxWeight_;
0199 
0200   /**
0201    * The option for the energy dependence of the prefactor
0202    */
0203   vector<int> option_;
0204 
0205   /**
0206    * The constants for the omnes function form.
0207    */
0208   InvEnergy2 aConst_;
0209 
0210   /**
0211    * The constants for the Omnes function form.
0212    */
0213   double cConst_;
0214 
0215   /**
0216    * The \f$\rho\f$ mass
0217    */
0218   Energy mRho_;
0219 
0220   /**
0221    * The \f$\rho\f$ width
0222    */
0223   Energy rhoWidth_;
0224 
0225   /**
0226    * Constant for the running \f$rho\f$ width.
0227    */
0228   double rhoConst_;
0229 
0230   /**
0231    * The \f$m_\pi\f$.
0232    */
0233   Energy mPi_;
0234 
0235   /**
0236    * Use local values of the parameters.
0237    */
0238   bool localParameters_;
0239 
0240   /**
0241    *  Object calculating the Omnes function
0242    */
0243   OmnesFunctionPtr omnesFunction_;
0244 
0245   /**
0246    *  Spin densit matrix
0247    */
0248   mutable RhoDMatrix rho_;
0249 
0250   /**
0251    *  Spinors for the fermions
0252    */
0253   mutable vector<Helicity::LorentzSpinor   <SqrtEnergy> > wave_;
0254 
0255   /**
0256    *  Barred spinors for the fermions 
0257    */
0258   mutable vector<Helicity::LorentzSpinorBar<SqrtEnergy> > wavebar_;
0259 };
0260 }
0261 
0262 #endif /* HERWIG_EtaPiPiFermionsDecayer_H */