Matchbox/Matching/DipoleMatching.h

0001 // -*- C++ -*-
0002 //
0003 // DipoleMatching.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_DipoleMatching_H
0010 #define Herwig_DipoleMatching_H
0011 //
0012 // This is the declaration of the DipoleMatching class.
0013 //
0014
0015 #include "Herwig/Shower/ShowerHandler.h"
0016 #include "Herwig/MatrixElement/Matchbox/Matching/ShowerApproximation.h"
0017
0018 namespace Herwig {
0019
0020 using namespace ThePEG;
0021
0022 /**
0023  * \ingroup Matchbox
0024  * \author Simon Platzer
0025  *
0026  * \brief DipoleMatching implements NLO matching with the dipole shower.
0027  *
0028  */
0029 class DipoleMatching: public Herwig::ShowerApproximation {
0030
0031 public:
0032
0033   /**
0034    * Return the shower approximation to the real emission cross
0035    * section for the given pair of Born and real emission
0036    * configurations.
0037    */
0038   virtual CrossSection dSigHatDR() const;
0039
0040   /**
0041    * Return the shower approximation splitting kernel for the given
0042    * pair of Born and real emission configurations in units of the
0043    * Born center of mass energy squared, and including a weight to
0044    * project onto the splitting given by the dipole used.
0045    */
0046   virtual double me2() const;
0047
0048 public:
0049
0050   /** @name Functions used by the persistent I/O system. */
0051   //@{
0052   /**
0053    * Function used to write out object persistently.
0054    * @param os the persistent output stream written to.
0055    */
0056   void persistentOutput(PersistentOStream & os) const;
0057
0058   /**
0059    * Function used to read in object persistently.
0060    * @param is the persistent input stream read from.
0061    * @param version the version number of the object when written.
0062    */
0063   void persistentInput(PersistentIStream & is, int version);
0064   //@}
0065
0066   /**
0067    * The standard Init function used to initialize the interfaces.
0068    * Called exactly once for each class by the class description system
0069    * before the main function starts or
0070    * when this class is dynamically loaded.
0071    */
0072   static void Init();
0073
0074 protected:
0075
0076   /** @name Clone Methods. */
0077   //@{
0078   /**
0079    * Make a simple clone of this object.
0080    * @return a pointer to the new object.
0081    */
0082   virtual IBPtr clone() const;
0083
0084   /** Make a clone of this object, possibly modifying the cloned object
0085    * to make it sane.
0086    * @return a pointer to the new object.
0087    */
0088   virtual IBPtr fullclone() const;
0089   //@}
0090
0091
0092 // If needed, insert declarations of virtual function defined in the
0093 // InterfacedBase class here (using ThePEG-interfaced-decl in Emacs).
0094
0095 protected:
0096
0097   /** @name Standard Interfaced functions. */
0098   //@{
0099   /**
0100    * Initialize this object after the setup phase before saving an
0101    * EventGenerator to disk.
0102    * @throws InitException if object could not be initialized properly.
0103    */
0104   virtual void doinit();
0105   //@}
0106
0107
0108 private:
0109
0110   /**
0111    * The shower handler to be used
0112    */
0113   Ptr<ShowerHandler>::ptr theShowerHandler;
0114
0115   /**
0116    * The assignment operator is private and must never be called.
0117    * In fact, it should not even be implemented.
0118    */
0119   DipoleMatching & operator=(const DipoleMatching &) = delete;
0120
0121 };
0122
0123 }
0124
0125 #endif /* Herwig_DipoleMatching_H */