Back to home page

EIC code displayed by LXR

 
 

    


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

0001 // -*- C++ -*-
0002 //
0003 // TwoPionRhoCurrent.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_TwoPionRhoCurrent_H
0010 #define HERWIG_TwoPionRhoCurrent_H
0011 // This is the declaration of the TwoPionRhoCurrent 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 TwoPionRhoCurrent: public WeakCurrent {
0055 
0056 public:
0057 
0058   /**
0059    * Default constructor
0060    */
0061   TwoPionRhoCurrent();
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   TwoPionRhoCurrent & operator=(const TwoPionRhoCurrent &) = 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     // calculate the BW
0216     if(imodel==0) {
0217       return Resonance::BreitWignerPWave(q2,_mass[ires],_width[ires],
0218                      _massa[ires],_massb[ires]);
0219     }
0220     else if(imodel==1) {
0221       return Resonance::BreitWignerGS(q2,_mass[ires],_width[ires],
0222                       _massa[ires],_massb[ires],
0223                       _h0[ires],_dh[ires],_hres[ires]);
0224     }
0225     else
0226       assert(false);
0227   }
0228 
0229 private:
0230 
0231   /**
0232    * Weights for the different \f$\rho\f$ resonances in the current, \f$\alpha_k\f$.
0233    */
0234   //@{
0235   /**
0236    *  The Complex weight used in the calculation
0237    */
0238   vector<Complex> _piwgt;
0239 
0240   /**
0241    *  The magnitude for input
0242    */
0243   vector<double> _pimag;
0244 
0245   /**
0246    *  The phase for input
0247    */
0248   vector<double> _piphase;
0249   //@}
0250 
0251   /**
0252    * Model to use for the \f$\rho\f$ propagator.
0253    */
0254   int _pimodel;
0255 
0256   /**
0257    * Option not to use the physical masses and widths for the \f$\rho\f$.
0258    */
0259   bool _rhoparameters;
0260 
0261   /**
0262    * The masses of the \f$\rho\f$ resonances.
0263    */
0264   vector<Energy> _rhomasses;
0265 
0266   /**
0267    * The widths of the \f$\rho\f$ resonances.
0268    */
0269   vector<Energy> _rhowidths;
0270 
0271   /**
0272    * Parameters for the Breit-Wigners
0273    */
0274   //@{
0275   /**
0276    * The masses of the resonances
0277    */
0278   vector<Energy> _mass;
0279 
0280   /**
0281    * The widths of the resonances
0282    */
0283   vector<Energy> _width;
0284 
0285   /**
0286    * Masses of the decay products for the momentum calculation.
0287    */
0288   vector<Energy> _massa,_massb;
0289 
0290   /**
0291    * The function \f$\frac{\\hat{H}}{dq^2}\f$ at \f$q^2=m^2\f$ for the GS form of the
0292    *  Breit-Wigner
0293    */
0294   vector<double> _dh;
0295 
0296   /**
0297    * The function \f$\\hat{H}\f$ at \f$q^2=m^2\f$ for the GS form of the
0298    *  Breit-Wigner
0299    */
0300   vector<Energy2> _hres;
0301 
0302   /**
0303    * The \f$H(0)\f$ parameter  for the GS form of the
0304    *  Breit-Wigner
0305    */
0306   vector<Energy2> _h0;
0307   //@}
0308 };
0309 
0310 }
0311 
0312 
0313 #endif /* HERWIG_TwoPionRhoCurrent_H */