Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // KPiKStarCurrent.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_KPiKStarCurrent_H
0010 #define HERWIG_KPiKStarCurrent_H
0011 // This is the declaration of the KPiKStarCurrent class.
0012 
0013 #include "WeakCurrent.h"
0014 #include "ThePEG/PDT/EnumParticles.h"
0015 #include "Herwig/Utilities/Kinematics.h"
0016 #include "ThePEG/StandardModel/StandardModelBase.h"
0017 #include "Herwig/Decay/ResonanceHelpers.h"
0018 
0019 namespace Herwig {
0020 using namespace ThePEG;
0021 
0022 /**  \ingroup Decay
0023  *
0024  *  Weak current for the production of two mesons via the \f$\rho\f$ or \f$K^*\f$
0025  *  resonances.
0026  *  These currents are taken from tau decays.
0027  *
0028  *  The current takes the form
0029  *
0030  *  \f[J^\mu = \frac{\sqrt{2}}{\sum_k\alpha_k}\left((p_1-p_2)^\mu-\frac{(p_1-p_2)\cdot q}{q^2}q^\mu))\right)
0031  *   \sum_k \alpha_k B_{R_k}(q^2)
0032  *  \f]
0033  *  where
0034  *  - \f$p_{1,2}\f$ are the momenta of the outgoing mesons,
0035  *  - \f$q=p_1+p_2\f$,
0036  *  - \f$B_{R_k}(q^2)\f$ is the Breit-Wigner distribution for the intermediate vector
0037  *    meson \f$R_k\f$.
0038  *  - \f$\alpha_k\f$ is the weight for the resonance.
0039  *
0040  *   The Breit-Wigner term is summed over the \f$\rho\f$ or \f$K^*\f$ resonances that
0041  *   can contribute to a given decay.
0042  *
0043  *  The models of either Kuhn and Santamaria (Z. Phys. C48, 445 (1990))
0044  *  or Gounaris and Sakurai Phys. Rev. Lett. 21, 244 (1968) are supported for the
0045  *  shape of the Breit-Wigner distribution. The mixing parameters
0046  *  are taken from Phys.Rev.D61:112002,2000 (CLEO) for the decay \f$\pi^\pm\pi^0\f$ and
0047  *  the CLEO version of TAUOLA for the \f$K\pi\f$ decays.
0048  *
0049  * @see WeakCurrent.
0050  * 
0051  *  \author Peter Richardson
0052  *
0053  */
0054 class KPiKStarCurrent: public WeakCurrent {
0055 
0056 public:
0057 
0058   /**
0059    * Default constructor
0060    */
0061   KPiKStarCurrent();
0062 
0063   /** @name Methods for the construction of the phase space integrator. */
0064   //@{
0065   /**
0066    * Complete the construction of the decay mode for integration.classes inheriting
0067    * from this one.
0068    * This method is purely virtual and must be implemented in the classes inheriting
0069    * from WeakCurrent.
0070    * @param icharge   The total charge of the outgoing particles in the current.
0071    * @param resonance If specified only include terms with this particle
0072    * @param flavour Information on the required flavours of the quarks
0073    * @param imode     The mode in the current being asked for.
0074    * @param mode      The phase space mode for the integration
0075    * @param iloc      The location of the of the first particle from the current in
0076    *                  the list of outgoing particles.
0077    * @param ires      The location of the first intermediate for the current.
0078    * @param phase     The prototype phase space channel for the integration.
0079    * @param upp       The maximum possible mass the particles in the current are
0080    *                  allowed to have.
0081    * @return Whether the current was sucessfully constructed.
0082    */
0083   virtual bool createMode(int icharge, tcPDPtr resonance,
0084               FlavourInfo flavour,
0085               unsigned int imode,PhaseSpaceModePtr mode,
0086               unsigned int iloc,int ires,
0087               PhaseSpaceChannel phase, Energy upp );
0088 
0089   /**
0090    * The particles produced by the current. This just returns the two pseudoscalar
0091    * mesons and the photon.
0092    * @param icharge The total charge of the particles in the current.
0093    * @param imode The mode for which the particles are being requested
0094    * @param iq The PDG code for the quark
0095    * @param ia The PDG code for the antiquark
0096    * @return The external particles for the current.
0097    */
0098   virtual tPDVector particles(int icharge, unsigned int imode, int iq, int ia);
0099   //@}
0100 
0101   /**
0102    * Hadronic current. This method is purely virtual and must be implemented in
0103    * all classes inheriting from this one.
0104    * @param resonance If specified only include terms with this particle
0105    * @param flavour Information on the required flavours of the quarks
0106    * @param imode The mode
0107    * @param ichan The phase-space channel the current is needed for.
0108    * @param scale The invariant mass of the particles in the current.
0109    * @param outgoing The particles produced in the decay
0110    * @param momenta  The momenta of the particles produced in the decay
0111    * @param meopt Option for the calculation of the matrix element
0112    * @return The current. 
0113    */
0114   virtual vector<LorentzPolarizationVectorE> 
0115   current(tcPDPtr resonance,
0116       FlavourInfo flavour,
0117       const int imode, const int ichan,Energy & scale,
0118       const tPDVector & outgoing,
0119       const vector<Lorentz5Momentum> & momenta,
0120       DecayIntegrator::MEOption meopt) const;
0121 
0122   /**
0123    * Accept the decay. Checks the particles are the allowed mode.
0124    * @param id The id's of the particles in the current.
0125    * @return Can this current have the external particles specified.
0126    */
0127   virtual bool accept(vector<int> id);
0128 
0129   /**
0130    * Return the decay mode number for a given set of particles in the current. 
0131    * @param id The id's of the particles in the current.
0132    * @return The number of the mode
0133    */
0134   virtual unsigned int decayMode(vector<int> id);
0135 
0136   /**
0137    * Output the setup information for the particle database
0138    * @param os The stream to output the information to
0139    * @param header Whether or not to output the information for MySQL
0140    * @param create Whether or not to add a statement creating the object
0141    */
0142   virtual void dataBaseOutput(ofstream & os,bool header,bool create) const;
0143 
0144 public:
0145 
0146   /** @name Functions used by the persistent I/O system. */
0147   //@{
0148   /**
0149    * Function used to write out object persistently.
0150    * @param os the persistent output stream written to.
0151    */
0152   void persistentOutput(PersistentOStream & os) const;
0153 
0154   /**
0155    * Function used to read in object persistently.
0156    * @param is the persistent input stream read from.
0157    * @param version the version number of the object when written.
0158    */
0159   void persistentInput(PersistentIStream & is, int version);
0160   //@}
0161 
0162   /**
0163    * Standard Init function used to initialize the interfaces.
0164    */
0165   static void Init();
0166 
0167 protected:
0168 
0169   /** @name Clone Methods. */
0170   //@{
0171   /**
0172    * Make a simple clone of this object.
0173    * @return a pointer to the new object.
0174    */
0175   virtual IBPtr clone() const {return new_ptr(*this);}
0176 
0177   /** Make a clone of this object, possibly modifying the cloned object
0178    * to make it sane.
0179    * @return a pointer to the new object.
0180    */
0181   virtual IBPtr fullclone() const {return new_ptr(*this);}
0182   //@}
0183 
0184 protected:
0185 
0186   /** @name Standard Interfaced functions. */
0187   //@{
0188 
0189   /**
0190    * Initialize this object after the setup phase before saving and
0191    * EventGenerator to disk.
0192    * @throws InitException if object could not be initialized properly.
0193    */
0194   virtual void doinit();
0195   //@}
0196 
0197 private:
0198 
0199   /**
0200    * Private and non-existent assignment operator.
0201    */
0202   KPiKStarCurrent & operator=(const KPiKStarCurrent &) = delete;
0203 
0204 private:
0205 
0206   /**
0207    * \f$p\f$-wave breit wigner for form-factors
0208    * @param q2 The scale \f$q^2\f$ for the Breit-Wigner
0209    * @param imodel Which of the two models for the Breit-Wigner shape to use.
0210    * @param ires   Which of the different multiplets to use.
0211    * @return The value of the Breit-Wigner distribution.
0212    */
0213   Complex BreitWigner(Energy2 q2, unsigned int imodel,
0214               unsigned int ires) const {
0215     // workout the index of the resonace
0216     // calculate the BW
0217     if(imodel==0) {
0218       return Resonance::BreitWignerPWave(q2,_mass[ires],_width[ires],
0219                      _massa[ires],_massb[ires]);
0220     }
0221     else if(imodel==1) {
0222       return Resonance::BreitWignerGS(q2,_mass[ires],_width[ires],
0223                       _massa[ires],_massb[ires],
0224                       _h0[ires],_dh[ires],_hres[ires]);
0225     }
0226     else
0227       assert(false);
0228   }
0229 
0230 private:
0231 
0232   /**
0233    * Weights for the different \f$K^*\f$ resonances in the current, \f$\alpha_k\f$.
0234    */
0235   //@{
0236   /**
0237    *  The Complex weight used in the calculation
0238    */
0239   vector<Complex> _kwgt;
0240 
0241   /**
0242    *  The magnitude for input
0243    */
0244   vector<double> _kmag;
0245 
0246   /**
0247    *  The phase for input
0248    */
0249   vector<double> _kphase;
0250   //@};
0251 
0252   /**
0253    * Model to use for the \f$K^*\f$ propagator.
0254    */
0255   int _kmodel;
0256   
0257   /**
0258    * Option not to use the physical masses and widths for the \f$K^*\f$.
0259    */
0260   bool _kstarparameters;
0261 
0262   /**
0263    *  The masses of the \f$K^*\f$ resonances.
0264    */
0265   vector<Energy> _kstarmasses;
0266 
0267   /**
0268    *  The masses of the \f$K^*\f$ resonances.
0269    */
0270   vector<Energy> _kstarwidths;
0271 
0272   /**
0273    * Parameters for the Breit-Wigners
0274    */
0275   //@{
0276   /**
0277    * The masses of the resonances
0278    */
0279   vector<Energy> _mass;
0280 
0281   /**
0282    * The widths of the resonances
0283    */
0284   vector<Energy> _width;
0285 
0286   /**
0287    * Masses of the decay products for the momentum calculation.
0288    */
0289   vector<Energy> _massa,_massb;
0290 
0291   /**
0292    * The function \f$\frac{\\hat{H}}{dq^2}\f$ at \f$q^2=m^2\f$ for the GS form of the
0293    *  Breit-Wigner
0294    */
0295   vector<double> _dh;
0296 
0297   /**
0298    * The function \f$\\hat{H}\f$ at \f$q^2=m^2\f$ for the GS form of the
0299    *  Breit-Wigner
0300    */
0301   vector<Energy2> _hres;
0302 
0303   /**
0304    * The \f$H(0)\f$ parameter  for the GS form of the
0305    *  Breit-Wigner
0306    */
0307   vector<Energy2> _h0;
0308   //@}
0309 };
0310 
0311 }
0312 
0313 
0314 #endif /* HERWIG_KPiKStarCurrent_H */