|
|
| EventHandler (bool warnincomplete=true) |
| Default constructor.
|
|
| EventHandler (const EventHandler &) |
| Copy-constructor.
|
|
virtual | ~EventHandler () |
| Destructor.
|
|
|
virtual void | initialize () |
| Initialize this event handler and all related objects needed to generate events.
|
|
virtual EventPtr | generateEvent () |
| Generate an event. More...
|
|
tEventPtr | generateEvent (tEventPtr e) |
| Generate an Event, where the initial state is supplied from the outside. More...
|
|
tEventPtr | generateEvent (tStepPtr s) |
| Generate an Event, where the initial state is supplied as a single step from the outside. More...
|
|
virtual EventPtr | continueEvent () |
| Continue generating an event if the generation has been stopped before finishing.
|
|
tCollPtr | continueCollision () |
| Continue the generation of a Collision. More...
|
|
void | clearEvent () |
| Clear all step handlers, making the handler ready for a new event.
|
|
virtual void | select (tXCombPtr newXComb) |
| Change the XComb object.
|
|
virtual bool | empty () const |
| Returns true if there are no step handlers left to apply to the current event;.
|
|
virtual void | statistics (ostream &) const |
| Write out accumulated statistics about intergrated cross sections and stuff.
|
|
virtual CrossSection | histogramScale () const |
| Histogram scale. More...
|
|
virtual CrossSection | integratedXSec () const |
| The total integrated cross section of the processes generated in this run. More...
|
|
virtual CrossSection | integratedXSecErr () const |
| The estimated error in the total integrated cross section of the processes generated in this run. More...
|
|
|
long | maxLoop () const |
| Return the maximum number attemts allowed to select a sub-process for each event.
|
|
const cPDPair & | incoming () const |
| The pair of incoming particle types. More...
|
|
const LuminosityFunction & | lumiFn () const |
| Access the luminosity function.
|
|
tcLumiFnPtr | lumiFnPtr () const |
| Access the luminosity function.
|
|
tLumiFnPtr | lumiFnPtr () |
| Access to the luminosity function.
|
|
tCutsPtr | cuts () const |
| The kinematical cuts to used by subclasses which do not provide their own.
|
|
tPExtrPtr | partonExtractor () const |
| A PartonExtractor object to be used by sub classes which do not provide their own.
|
|
tCascHdlPtr | CKKWHandler () const |
| Return a pointer (possibly null) to the assigned main CascadeHandler to be used as CKKW-reweighter.
|
|
tEventPtr | currentEvent () const |
| Gget current event.
|
|
tCollPtr | currentCollision () const |
| Get current collision.
|
|
tStepPtr | currentStep () const |
| Get current step.
|
|
int | statLevel () const |
| The level of statistics. More...
|
|
ConsistencyLevel | consistencyLevel () const |
| Determines how often the event handler should check for charge and energy-momentum conservation.
|
|
double | consistencyEpsilon () const |
| The maximum fraction of the total invariant mass of a collision that any of the components of the summed momentum is allowed to change during the generation.
|
|
|
|
void | performStep (tStepHdlPtr handler, tHintPtr hint) |
| Perform a given step using a handler and a hint.
|
|
void | addStep (Group::Level, Group::Handler, tStepHdlPtr=tStepHdlPtr(), tHintPtr=tHintPtr()) |
| In the curresnt list of step handlers to go through, add another step handler and/or hint.
|
|
tStepPtr | newStep (tcStepHdlPtr sh) |
| Create a new step and make it current. More...
|
|
void | popStep () |
| Remove the last step.
|
|
virtual void | initGroups () |
| Initialize the groups of step handlers.
|
|
void | currentEvent (tEventPtr e) |
| Set current event.
|
|
void | currentCollision (tCollPtr c) |
| Set current collision.
|
|
void | currentStep (tStepPtr s) |
| Set current step.
|
|
tStepHdlPtr | currentStepHandler () const |
| Get current StepHandler.
|
|
void | currentStepHandler (tStepHdlPtr sh) |
| Set current StepHandler.
|
|
void | throwCurrent () |
| Throw away the current event/collision.
|
|
virtual void | clean () |
| Throw away the last generated event before generating a new one.
|
|
virtual void | checkConsistency () const |
| Check that the charge and energy-momentum in the last step of the current collision is consistent with the incoming particles. More...
|
|
|
void | persistentOutput (PersistentOStream &os) const |
| Function used to write out object persistently. More...
|
|
void | persistentInput (PersistentIStream &is, int version) |
| Function used to read in object persistently. More...
|
|
Public Member Functions inherited from ThePEG::HandlerBaseT< UseRandom > |
double | rnd () const |
| Return a simple flat random number in the range ]0,1[.
|
|
double | rnd (double xu) const |
| Return a simple flat random number in the range ]0,xu[.
|
|
double | rnd (double xl, double xu) const |
| Return a simple flat random number in the range ]xl,xu[.
|
|
bool | rndbool () const |
| Return true with 50% probability.
|
|
bool | rndbool (double p) const |
| Return a true with probability p.
|
|
bool | rndbool (double p1, double p2) const |
| Return a true with probability p1/(p1+p2).
|
|
int | rndsign (double p1, double p2, double p3) const |
| Return -1, 0, or 1 with relative probabilities p1, p2, p3.
|
|
int | rnd2 (double p0, double p1) const |
| Return an integer with probability p /(p0+p1).
|
|
int | rnd3 (double p0, double p1, double p2) const |
| Return an integer with probability p /(p0+p1+p2).
|
|
int | rnd4 (double p0, double p1, double p2, double p3) const |
| Return an integer/ with probability p (p0+p1+p2+p3).
|
|
long | irnd (long xu=2) const |
| Return a simple flat random integrer number in the range [0,xu[.
|
|
long | irnd (long xl, long xu) const |
| Return a simple flat random integrer number in the range [xl,xu[.
|
|
const StandardModelBase & | SM () const |
| Return a reference to the object containing the standard model parameters for this run.
|
|
tSMPtr | standardModel () const |
| Return a pointer to the object containing the standard model parameters for this run.
|
|
virtual | ~HandlerBaseT () |
| Destructor.
|
|
virtual | ~Interfaced () |
| Empty virtual destructor.
|
|
virtual bool | defaultInit () |
| Functions which are to be used during the actual event generation, after the setup is complete. More...
|
|
PPtr | getParticle (PID) const |
| Create a new Particle instance given a id number.
|
|
PDPtr | getParticleData (PID) const |
| Return a pointer to the ParticleData object corresponding to the given id number.
|
|
bool | used () const |
| Returns true if this object has actally been used.
|
|
void | useMe () const |
| Should be called to indicate that this object has actually been used.
|
|
tEGPtr | generator () const |
| Return a pointer to the EventGenerator controlling the run. More...
|
|
void | persistentOutput (PersistentOStream &os) const |
| Function used to write out object persistently. More...
|
|
void | persistentInput (PersistentIStream &is, int version) |
| Function used to read in object persistently. More...
|
|
virtual | ~InterfacedBase () |
| The virtual (empty) destructor;.
|
|
string | fullName () const |
| Returns the full name of this object including its path, e.g. More...
|
|
string | name () const |
| Returns the name of this object, without the path.
|
|
string | path () const |
| Returns the path to this object including the trailing '/'. More...
|
|
string | comment () const |
| Returns a comment assigned to this object.
|
|
void | setup (istream &is) |
| Read setup info from a standard istream is. More...
|
|
virtual void | debugme () const |
| Print out debugging information for this object on std::cerr. More...
|
|
void | update () |
| Calls the doupdate() function with recursion prevention.
|
|
void | init () |
| Calls the doinit() function with recursion prevention.
|
|
virtual bool | preInitialize () const |
| Return true if this object needs to be initialized before all other objects (except those for which this function also returns true). More...
|
|
void | initrun () |
| Calls the doinitrun() function with recursion prevention.
|
|
void | finish () |
| Calls the dofinish() function with recursion prevention.
|
|
void | touch () |
| This function should be called every time something in this object has changed in a way that a sanity check with update() is needed.
|
|
void | reset () |
| Set the state of this object to uninitialized.
|
|
void | clear () |
| Calls reset() and unTouch().
|
|
InitState | state () const |
| Return the state of initialization of this object.
|
|
bool | locked () const |
| Return true if the BaseRepository is not allowed to change the state of this object.
|
|
bool | touched () const |
| Return true if the state of this object has been changed since the last call to update().
|
|
void | persistentOutput (PersistentOStream &os) const |
| Function used to write out object persistently. More...
|
|
void | persistentInput (PersistentIStream &is, int version) |
| Function used to read in object persistently. More...
|
|
virtual | ~Base () |
| The virtual destructor.
|
|
void | debug () const |
| Print out debugging information for this object on std::cerr. More...
|
|
CounterType | referenceCount () const |
| Return the reference count.
|
|
| Named (const string &newName=string()) |
| Constructor with name.
|
|
const string & | name () const |
| Return name.
|
|
bool | operator== (const Named &other) const |
| Test for equality.
|
|
bool | operator< (const Named &other) const |
| Lexicographical comparison.
|
|
const XComb & | lastXComb () const |
| Return a reference to the last selected XComb.
|
|
tXCPtr | lastXCombPtr () const |
| Return a pointer to the last selected XComb.
|
|
const XComb & | lastHeadXComb () const |
| If the last selected XComb object belongs to a group of XComb's return a reference to the head XComb object for this group.
|
|
tXCPtr | lastHeadXCombPtr () const |
| If the last selected XComb object belongs to a group of XComb's return a pointer to the head XComb object for this group.
|
|
const EventHandler & | lastEventHandler () const |
| Return a reference to the currently used EventHandler.
|
|
tPExtrPtr | lastExtractor () const |
| A pointer to the currently used parton extractor.
|
|
PDFT | pdf (tcPPtr parton) const |
| Return the parton density used to extract the given parton. More...
|
|
const Cuts & | lastCuts () const |
| A reference to the currently used kinematical cuts.
|
|
tCutsPtr | lastCutsPtr () const |
| A pointer to the currently used kinematical cuts.
|
|
const PPair & | lastParticles () const |
| Return the pair of incoming parton instances.
|
|
Energy2 | lastS () const |
| The last generated total energy squared of the incoming particles.
|
|
const PPair & | lastPartons () const |
| Return the pair of incoming parton instances.
|
|
Energy2 | lastSHat () const |
| The last used interval in total parton-parton energy squared.
|
|
double | lastTau () const |
| Return lastSHat()/lastS().
|
|
double | lastY () const |
| The generated rapidity of the hard scattering sub-system.
|
|
double | lastP1 () const |
| Log of one over the momentum fraction of the first incoming particle w.r.t. More...
|
|
double | lastP2 () const |
| Log of one over the momentum fraction of the second incoming particle w.r.t. More...
|
|
double | lastL1 () const |
| Log of one over the first incoming parton momentum fraction w.r.t. More...
|
|
double | lastL2 () const |
| Log of one over the second incoming parton momentum fraction w.r.t. More...
|
|
double | lastX1 () const |
| The first incoming parton momentum fraction w.r.t. More...
|
|
double | lastX2 () const |
| The second incoming parton momentum fraction w.r.t. More...
|
|
double | lastE1 () const |
| Return 1-lastX1() to highest possible precision for x 1.
|
|
double | lastE2 () const |
| Return 1-lastX2() to highest possible precision for x 1.
|
|
double | lastFL1L2 () const |
| The product of the parton density functions at the last generated phase-space point.
|
|
Energy2 | lastScale () const |
| The chosen scale of the hard scattering.
|
|
double | lastAlphaS () const |
| Get the used in the hard scattering. More...
|
|
double | lastAlphaEM () const |
| Get the used in the hard scattering. More...
|
|
const vector< Lorentz5Momentum > & | meMomenta () const |
| Return the momenta of the incoming and outgoing partons to be used by the matrix element object, in the order specified by the TreeDiagram objects given by the matrix element.
|
|
double | lastME2 () const |
| Return the matrix element squared as calculated for the last phase space point. More...
|
|
double | jacobian () const |
| Get the last jacobian obtained when generating the kinematics for the call to dSigHatDR.
|
|
CrossSection | lastMECrossSection () const |
| Return the partonic cross section as calculated for the last phase space point. More...
|
|
double | lastMEPDFWeight () const |
| Return the PDF weight as calculated for the last phase space point, if the matrix element does supply PDF weights. More...
|
|
tSubProPtr | subProcess () const |
| Return the SubProcess object corresponding to the last generated sub-process.
|
|
const cPDVector & | mePartonData () const |
| Return the incoming and outgoing parton types to be used by the matrix element object, in the order specified by the TreeDiagram objects given by the matrix element.
|
|
|
void | interfaceSetPostSubProcessHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPostSubProcessHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePostSubProcessHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPostSubProcessHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPreCascadeHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPreCascadeHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePreCascadeHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPreCascadeHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetCascadeHandler (CascHdlPtr) |
| Utility function for the interface. More...
|
|
CascHdlPtr | interfaceGetCascadeHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPostCascadeHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPostCascadeHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePostCascadeHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPostCascadeHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPreMultipleInteractionHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPreMultipleInteractionHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePreMultipleInteractionHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPreMultipleInteractionHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetMultipleInteractionHandler (MIHdlPtr) |
| Utility function for the interface. More...
|
|
MIHdlPtr | interfaceGetMultipleInteractionHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPostMultipleInteractionHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPostMultipleInteractionHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePostMultipleInteractionHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPostMultipleInteractionHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPreHadronizationHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPreHadronizationHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePreHadronizationHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPreHadronizationHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetHadronizationHandler (HadrHdlPtr) |
| Utility function for the interface. More...
|
|
HadrHdlPtr | interfaceGetHadronizationHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPostHadronizationHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPostHadronizationHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePostHadronizationHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPostHadronizationHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPreDecayHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPreDecayHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePreDecayHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPreDecayHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetDecayHandler (DecayHdlPtr) |
| Utility function for the interface. More...
|
|
DecayHdlPtr | interfaceGetDecayHandler () const |
| Utility function for the interface. More...
|
|
void | interfaceSetPostDecayHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceInsertPostDecayHandler (StepHdlPtr, int) |
| Utility function for the interface. More...
|
|
void | interfaceErasePostDecayHandler (int) |
| Utility function for the interface. More...
|
|
vector< StepHdlPtr > | interfaceGetPostDecayHandler () const |
| Utility function for the interface. More...
|
|
EventHandler & | operator= (const EventHandler &) |
| Private and non-existent assignment operator.
|
|
The EventHandler is the base class used to implement event handlers in ThePEG.
Objects of this class is assigned to an EventGenerator object which supervises a run. This base class is not able to generate complete events, although it does have a virtual generateEvent(). If the EventGenerator to which an EventGenerator is assinged is asked to generate a full event, it will call the generateEvent() function which will write an error message and abort the run.
Objects of this base class can, however, be used to administer the evolution of a partially generated event supplied from the outside. To specify this event evolution the EventHandler maintains five groups of so-called StepHandlers implemented as HandlerGroups. Each group have a main step handler: SubProcessHandler, CascadeHandler, MultipleInteractionHandler, HadronizationHandler and DecayHandler respectively, whereof the first group only uses the post-handler part of the group.
The EventHandler class inherits from the LastXCombInfo class to have easy interface to the information in the last selected XComb which carries information about the hard sub-process in the event.
If a sub-class implements the generation of sub-processes and thus becomes a full event handler it should implement the generateEvent() function appropriately. It should also set the flag warnIncomplete to false, to avoid warnings when initialized as the main EventHandler of an Eventgenerator.
- See also
- The interfaces defined for EventHandler.
-
Collision
-
StepHandler
-
HandlerGroup
-
SubProcessHandler
-
CascadeHandler
-
MultipleInteractionHandler
-
HadronizationHandler
-
DecayHandler
Definition at line 63 of file EventHandler.h.