ThePEG::CascadeHandler Class Reference

The CascadeHandler is the base class of all handlers implementing perturbative partonic cascade models. More...

#include <CascadeHandler.h>

Inheritance diagram for ThePEG::CascadeHandler:

ThePEG::StepHandler ThePEG::LastXCombInfo< XC > ThePEG::HandlerBase ThePEG::HandlerBaseT< T > ThePEG::Interfaced ThePEG::InterfacedBase ThePEG::Base ThePEG::Named ThePEG::Pointer::ReferenceCounted

List of all members.

Public Member Functions

virtual void cascade ()=0
 The main function to be overwritten by sub-classes.
virtual double reweightCKKW (int minMult, int maxMult)
 The CascadeHandler can be used inside the process generation to do so-called CKKW reweighting of the hard sub-process.
Standard constructors and destructors.
virtual ~CascadeHandler ()
 The destructor.
Virtual functions required by the StepHandler class.
virtual void handle (EventHandler &eh, const tPVector &tagged, const Hint &hint)
 The main function called by the EventHandler class to perform a step.
Access information stored by the handle() function.
const tPVectortagged () const
 Return the vector of tagged particles which should be showered.
const Hinthint () const
 Return the int provided in the current call to handle().
const PDFfirstPDF () const
 Return references to the PDF used by the first incoming particle.
const PDFsecondPDF () const
 Return references to the PDF used by the first incoming particle.
const pair< PDF, PDF > & pdfs () const
 Return references to the currently used PDF's.
void resetPDFs (const pair< tcPDFPtr, tcPDFPtr > &pdfpair)
 Set alternative PDFBase objects to be used for cascade.
void setXComb (tXCombPtr xc)
 Set the XComb object with information about the sub-process generation.

Static Public Member Functions

static void Init ()
 Standard Init function used to initialize the interface.

Private Member Functions

CascadeHandleroperator= (const CascadeHandler &)
 Private and non-existent assignment operator.

Private Attributes

const tPVectortheTagged
 Store the tagged argument given to handle().
const HinttheHint
 Store the Hint arguments given to handle().
pair< PDF, PDFthePDFs
 The pdfs used to extract the incoming partons.

Static Private Attributes

static
AbstractNoPIOClassDescription
< CascadeHandler
initCascadeHandler
 The static object used to initialize the description of this class.


Detailed Description

The CascadeHandler is the base class of all handlers implementing perturbative partonic cascade models.

It is derived from the more general StepHandler class, and implements the handle() function to do some standard initialization before calling the main cascade() function.

See also:
The interfaces defined for CascadeHandler.

StepHandler

EventHandler

SubProcessHandler

Definition at line 33 of file CascadeHandler.h.


Member Function Documentation

virtual void ThePEG::CascadeHandler::handle ( EventHandler eh,
const tPVector tagged,
const Hint hint 
) [virtual]

The main function called by the EventHandler class to perform a step.

Parameters:
eh the EventHandler in charge of the Event generation.
tagged if not empty these are the only particles which should be considered by the StepHandler.
hint a Hint object with possible information from previously performed steps.
Exceptions:
Veto if the StepHandler requires the current step to be discarded.
Stop if the generation of the current Event should be stopped after this call.
Exception if something goes wrong.

Implements ThePEG::StepHandler.

virtual void ThePEG::CascadeHandler::cascade (  )  [pure virtual]

The main function to be overwritten by sub-classes.

It is called by handle() after storing some information which is then available through simple access functions.

virtual double ThePEG::CascadeHandler::reweightCKKW ( int  minMult,
int  maxMult 
) [virtual]

The CascadeHandler can be used inside the process generation to do so-called CKKW reweighting of the hard sub-process.

In this case this function is called after information about the sub-process is made available through the LastXCombInfo base class. Only the function belonging to the primary CascadeHandler for the event to be generated is called. Sub-classes may implement it to give a suitable weight in return. The CascadeHandler may store information about the generated sub-process to be used in the subsequent cascade. It is however not guaranteed that the reweightCKKW() will have been called for the subprocess handed to the handle() function. This default implementation of the function simply return one. The current sub-process is mixed together with other processes with a multiplicity of outgoing particles between minMult and maxMult.

const tPVector& ThePEG::CascadeHandler::tagged (  )  const [inline]

Return the vector of tagged particles which should be showered.

It the vector is empty, the patons from the current sub-process is supposed to be showered.

Definition at line 102 of file CascadeHandler.h.

References theTagged.


Member Data Documentation

The static object used to initialize the description of this class.

Indicates that this is an abstract class without persistent data.

Definition at line 166 of file CascadeHandler.h.


The documentation for this class was generated from the following file:

Generated on Thu Apr 29 12:43:02 2010 for ThePEG by  doxygen 1.5.5