Back to home page

EIC code displayed by LXR

 
 

    


File indexing completed on 2026-08-06 09:23:59

0001 // -*- C++ -*-
0002 #ifndef Herwig_VectorTo3PseudoScalarDalitz_H
0003 #define Herwig_VectorTo3PseudoScalarDalitz_H
0004 //
0005 // This is the declaration of the VectorTo3PseudoScalarDalitz class.
0006 //
0007 
0008 #include "DalitzBase.h"
0009 #include "ThePEG/Helicity/LorentzPolarizationVector.h"
0010 
0011 namespace Herwig {
0012 
0013 using namespace ThePEG;
0014 
0015 /**
0016  * The VectorTo3PseudoScalarDalitz class provides a base class for the decay of vector mesons to 3 pseudoscalar mesons
0017  *
0018  * @see \ref VectorTo3PseudoScalarDalitzInterfaces "The interfaces"
0019  * defined for VectorTo3PseudoScalarDalitz.
0020  */
0021 class VectorTo3PseudoScalarDalitz: public DalitzBase {
0022 
0023 public:
0024 
0025   /**
0026    * The default constructor.
0027    */
0028   VectorTo3PseudoScalarDalitz() : coupling_(1./GeV)
0029   {}
0030 
0031   /**
0032    * Return the matrix element squared for a given mode and phase-space channel.
0033    * @param ichan The channel we are calculating the matrix element for. 
0034    * @param part The decaying Particle.
0035    * @param outgoing The particles produced in the decay
0036    * @param momenta  The momenta of the particles produced in the decay
0037    * @param meopt Option for the calculation of the matrix element
0038    * @return The matrix element squared for the phase-space configuration.
0039    */
0040   virtual double me2(const int ichan,const Particle & part,
0041              const tPDVector & outgoing,
0042              const vector<Lorentz5Momentum> & momenta,
0043              MEOption meopt) const;
0044 
0045   /**
0046    *   Construct the SpinInfos for the particles produced in the decay
0047    */
0048   virtual void constructSpinInfo(const Particle & part,
0049                  ParticleVector outgoing) const;
0050 
0051   /**
0052    * Output the setup information for the particle database
0053    * @param os The stream to output the information to
0054    * @param header Whether or not to output the information for MySQL
0055    */
0056   virtual void dataBaseOutput(ofstream & os,bool header) const;
0057 
0058   /**
0059    * Method to return an object to calculate the 3 body partial width.
0060    * @param dm The DecayMode
0061    * @return A pointer to a WidthCalculatorBase object capable of calculating the width
0062    */
0063   virtual WidthCalculatorBasePtr threeBodyMEIntegrator(const DecayMode & dm) const;
0064 
0065   /**
0066    * The matrix element to be integrated for the three-body decays as a function
0067    * of the invariant masses of pairs of the outgoing particles.
0068    * @param imode The mode for which the matrix element is needed.
0069    * @param q2 The scale, \e i.e. the mass squared of the decaying particle.
0070    * @param s3 The invariant mass squared of particles 1 and 2, \f$s_3=m^2_{12}\f$.
0071    * @param s2 The invariant mass squared of particles 1 and 3, \f$s_2=m^2_{13}\f$.
0072    * @param s1 The invariant mass squared of particles 2 and 3, \f$s_1=m^2_{23}\f$.
0073    * @param m1 The mass of the first  outgoing particle.
0074    * @param m2 The mass of the second outgoing particle.
0075    * @param m3 The mass of the third  outgoing particle.
0076    * @return The matrix element
0077    */
0078   virtual double threeBodyMatrixElement(const int imode, const Energy2 q2,
0079                     const  Energy2 s3, const Energy2 s2, const 
0080                     Energy2 s1, const Energy m1,
0081                     const Energy m2, const Energy m3) const;
0082 
0083 public:
0084 
0085   /** @name Functions used by the persistent I/O system. */
0086   //@{
0087   /**
0088    * Function used to write out object persistently.
0089    * @param os the persistent output stream written to.
0090    */
0091   void persistentOutput(PersistentOStream & os) const;
0092 
0093   /**
0094    * Function used to read in object persistently.
0095    * @param is the persistent input stream read from.
0096    * @param version the version number of the object when written.
0097    */
0098   void persistentInput(PersistentIStream & is, int version);
0099   //@}
0100 
0101   /**
0102    * The standard Init function used to initialize the interfaces.
0103    * Called exactly once for each class by the class description system
0104    * before the main function starts or
0105    * when this class is dynamically loaded.
0106    */
0107   static void Init();
0108 
0109 protected:
0110 
0111   /** @name Clone Methods. */
0112   //@{
0113   /**
0114    * Make a simple clone of this object.
0115    * @return a pointer to the new object.
0116    */
0117   virtual IBPtr clone() const;
0118 
0119   /** Make a clone of this object, possibly modifying the cloned object
0120    * to make it sane.
0121    * @return a pointer to the new object.
0122    */
0123   virtual IBPtr fullclone() const;
0124   //@}
0125 
0126 protected:
0127   
0128   /**
0129    *  Calculate the amplitude
0130    */
0131   virtual complex<InvEnergy2> amplitude(int ichan) const {
0132     complex<InvEnergy2> amp(ZERO);
0133     int iloc=-1;
0134     for(int ix=0;ix<int(resonances().size());++ix) {
0135       ++iloc;
0136       if(channel1()>=0) {
0137     if(ix!=channel1() && ix!=channel2()) continue;
0138       }
0139       if(ichan>=0&&ichan!=iloc) continue;
0140       amp += resAmp(ix);
0141     }
0142     return amp;
0143   }
0144 
0145   /**
0146    * Calculate the amplitude for the ith resonance
0147    */
0148   complex<InvEnergy2> resAmp(unsigned int i) const;
0149 
0150 private:
0151 
0152   /**
0153    * The assignment operator is private and must never be called.
0154    * In fact, it should not even be implemented.
0155    */
0156   VectorTo3PseudoScalarDalitz & operator=(const VectorTo3PseudoScalarDalitz &) = delete;
0157 
0158 private:
0159 
0160   /**
0161    *  Coupling for the normalisation of the mode
0162    */
0163   InvEnergy coupling_;
0164 
0165   /**
0166    *   Storage of the kinematics
0167    */
0168   //@{
0169   /**
0170    *   Mass of the parent
0171    */
0172   mutable Energy mD_;
0173 
0174   /**
0175    *   Masses of the children
0176    */
0177   mutable Energy mOut_[3];
0178 
0179   /**
0180    *   Masses of the children
0181    */
0182   mutable Energy m2_[3][3];
0183   //@}
0184   
0185   /**
0186    *  Storage of polarization vectors to try and increase
0187    *  speed
0188    */
0189   mutable vector<Helicity::LorentzPolarizationVector> vectors_;
0190   
0191   /**
0192    *   Storage of the \f$\rho\f$ matrix
0193    */
0194   mutable RhoDMatrix rho_;
0195 
0196 };
0197 
0198 }
0199 
0200 #endif /* Herwig_VectorTo3PseudoScalarDalitz_H */