Pythia7::SpaceShowerHandler Class Reference

SpaceShowerHandler is a wrapper around the internal Shower::SpaceShower class to perform a space-like parton shower. More...

#include <SpaceShowerHandler.h>

Inheritance diagram for Pythia7::SpaceShowerHandler:

List of all members.

Public Member Functions

Shower::SpaceShower * getModel ()

Set the static parameters of the underlying model object and return an instance.

int hadronShower () const

Allowed ISR showers for incoming hadron: = 0: none; = 1: QCD ones; = 2 : also allow photon emission; = 3 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).

int leptonShower () const

Allowed ISR showers for incoming lepton: = 0: none; = 1: photon emission; = 2 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).

int nQuarks () const

Number of allowed quark flavours in $g\rightarrow q \bar{q}$ branching.

int alphaSMode () const

Running of alpha_strong in evolution: = 0: fixed; = 1: scale $Q^2$ ; = 2: scale $p_\perp^2$ .

int maxVirtuality () const

Maximum virtuality setting the starting point of the evolution: = 0: $s$ ; = 1: $\hat{s}$ ; = 2: average $m_\perp^2$ ; = 3: smallest $m_\perp^2$ .

int MEMode () const

Use of matrix element corrections: = 0: no; = 1: yes.

int softGluonResum () const

Resum the effect of multiple soft gluon emissions: = 0: no; = 1: yes.

int finalCone () const

Restrict first emission within cone given by colour flow in hard process.

int Q2Order () const

Q2 ordering is normal, but could be relaxed (to be developed in future).

bool angularOrdering () const

Use angular ordering?

int phiPolAsym () const

Azimuthal asymmetry induced by gluon polarization.

int phiCoherAsym () const

Azimuthal asymmetry induced by colour coherence.

int respectScale () const

Use the scale variable of original partons to restrict branchings.

Energy Q0 () const

Parton shower cut-off mass for QCD emissions.

Energy Q0ChgQ () const

Parton shower cut-off mass for photon coupling to coloured particle.

Energy Q0ChgL () const

Parton shower cut-off mass for pure QED branchings.

double alphaSFix () const

Fixed alpha_strong value for AlphaSMode == 0.

Energy Lambda5 () const

Lambda_QCD(five flavours) in alpha_strong for AlphaSMode >= 1.

double alphaEMFix () const

Fixed alpha_em value.

Energy EMinEmitted () const

Minimum energy of emitted QCD parton in rest frame of subprocess.

double zMinEmitted () const

Minimum fraction $1 - z$ of emitted QCD parton, in addition to other limits.

double xMinEmittedChg () const

Minimum $x$ fraction of emitted photon - matched to treatment of photon PDF.

Energy tinyQChg () const

Smallest particle mass for QED evolution (= electron mass).

double tinyPDF () const

Vanishingly small parton density.

double tinyKernelPDF () const

Vanishingly small product of splitting kernels and parton density ratios.

double tinyKinPrec () const

Vanishingly small recoil mass in branching kinematics reconstruction.

double heavyEvol () const

Safety margin in $x$ that heavy flavour evolution is at all possible.

double extraPreweight () const

Extra preweight in QED shower evolution, to avoid maximum violation.

double heavyMax () const

Maximum allowed $x$ when reconstructing back to heavy flavour from gluon or photon.

double Q2StartFrac () const

Mimimum gap in $Q^2$ values to allow iteration when parton density vanishes.

Standard constructors and destructors.

SpaceShowerHandler ()

The default constructor.

SpaceShowerHandler (const SpaceShowerHandler &)

The copy constructor.

virtual ~SpaceShowerHandler ()

The destructor.

Functions used by the persistent I/O system.

void persistentOutput (PersistentOStream &os) const

Function used to write out object persistently.

void persistentInput (PersistentIStream &is, int version)

Function used to read in object persistently.

Static Public Member Functions

static void Init ()

Standard Init function used to initialize the interfaces.

Protected Member Functions

Clone Methods.

virtual IBPtr clone () const

Make a simple clone of this object.

virtual IBPtr fullclone () const

Make a clone of this object, possibly modifying the cloned object to make it sane.

Standard Interfaced functions.

virtual void doupdate () throw (UpdateException)

Check sanity of the object during the setup phase.

virtual void doinit () throw (InitException)

Initialize this object after the setup phase before saving an EventGenerator to disk.

virtual void doinitrun ()

Initialize this object.

virtual void dofinish ()

Finalize this object.

virtual void rebind (const TranslationMap &trans) throw (RebindException)

Rebind pointer to other Interfaced objects.

virtual IVector getReferences ()

Return a vector of all pointers to Interfaced objects used in this object.

Private Member Functions

SpaceShowerHandler & operator= (const SpaceShowerHandler &)

Private and non-existent assignment operator.

Private Attributes

Shower::SpaceShower * theShowerModel

The object implementing the actual model.

int theHadronShower

Allowed ISR showers for incoming hadron: = 0: none; = 1: QCD ones; = 2 : also allow photon emission; = 3 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).

int theLeptonShower

Allowed ISR showers for incoming lepton: = 0: none; = 1: photon emission; = 2 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).

int theNQuarks

Number of allowed quark flavours in g -> q qbar branching.

int theAlphaSMode

Running of alpha_strong in evolution: = 0: fixed; = 1: scale Q^2; = 2: scale pT^2.

int theMaxVirtuality

Maximum virtuality setting the starting point of the evolution: = 0: s; = 1: sHat; = 2: average mT^2; = 3: smallest mT^2.

int theMEMode

Use of matrix element corrections: = 0: no; = 1: yes.

int theSoftGluonResum

Resum the effect of multiple soft gluon emissions: = 0: no; = 1: yes.

int theFinalCone

Restrict first emission within cone given by colour flow in hard process.

int theQ2Order

Q2 ordering is normal, but could be relaxed (to be developed in future).

int useAngularOrdering

Use angular ordering if non-zero.

int thePhiPolAsym

Azimuthal asymmetry induced by gluon polarization.

int thePhiCoherAsym

Azimuthal asymmetry induced by colour coherence.

int theRespectScale

Use the scale variable of original partons to restrict branchings.

Energy theQ0

Parton shower cut-off mass for QCD emissions.

Energy theQ0ChgQ

Parton shower cut-off mass for photon coupling to coloured particle.

Energy theQ0ChgL

Parton shower cut-off mass for pure QED branchings.

double theAlphaSFix

Fixed alpha_strong value for AlphaSMode == 0.

Energy theLambda5

Lambda_QCD(five flavours) in alpha_strong for AlphaSMode >= 1.

double theAlphaEMFix

Fixed alpha_em value.

Energy theEMinEmitted

Minimum energy of emitted QCD parton in rest frame of subprocess.

double theZMinEmitted

Minimum fraction 1 - z of emitted QCD parton, in addition to other limits.

double theXMinEmittedChg

Minimum x fraction of emitted photon - matched to treatment of photon PDF.

Energy theTinyQChg

Smallest particle mass for QED evolution (= electron mass).

double theTinyPDF

Vanishingly small parton density.

double theTinyKernelPDF

Vanishingly small product of splitting kernels and parton density ratios.

double theTinyKinPrec

Vanishingly small recoil mass in branching kinematics reconstruction.

double theHeavyEvol

Safety margin in x that heavy flavour evolution is at all possible.

double theExtraPreweight

Extra preweight in QED shower evolution, to avoid maximum violation.

double theHeavyMax

Maximum allowed x when reconstructing back to heavy flavour from gluon or photon.

double theQ2StartFrac

Mimimum gap in Q2 values to allow iteration when parton density vanishes.

Static Private Attributes

static ClassDescription
< SpaceShowerHandler > initSpaceShowerHandler

Describe a concrete class with persistent data.

Detailed Description

SpaceShowerHandler is a wrapper around the internal Shower::SpaceShower class to perform a space-like parton shower.

See also:: The interfaces defined for SpaceShowerHandler.

Definition at line 23 of file SpaceShowerHandler.h.

Member Function Documentation

int Pythia7::SpaceShowerHandler::alphaSMode ( ) const [inline]

Running of alpha_strong in evolution: = 0: fixed; = 1: scale $Q^2$ ; = 2: scale $p_\perp^2$ .

But note that PDF's are always evaluated at $Q^2$ .

int Pythia7::SpaceShowerHandler::finalCone ( ) const [inline]

Restrict first emission within cone given by colour flow in hard process.

= 0: no; = 1: yes, isotropic phi angle inside cone; = 2: yes, also with anisotropic phi angle inside cone.

int Pythia7::SpaceShowerHandler::Q2Order ( ) const [inline]

Q2 ordering is normal, but could be relaxed (to be developed in future).

= 0: yes; = 1: no, allow maximum kinematically possible (toy scenario).

int Pythia7::SpaceShowerHandler::phiPolAsym ( ) const [inline]

Azimuthal asymmetry induced by gluon polarization.

= 0: no; = 1: yes.

int Pythia7::SpaceShowerHandler::phiCoherAsym ( ) const [inline]

Azimuthal asymmetry induced by colour coherence.

= 0: no; = 1: yes.

int Pythia7::SpaceShowerHandler::respectScale ( ) const [inline]

Use the scale variable of original partons to restrict branchings.

= 0: no; = 1: yes, $Q^2 <$ scale; = 2: yes, $p_\perp^2 <$ scale, = 3: yes, $(E\theta)^2 <$ scale; = 4: yes, $\theta^2 <$ scale. Here theta is the full opening angle of a branching, defined in the rest frame of the event. (In all cases relations are approximate.)

Energy Pythia7::SpaceShowerHandler::Q0ChgL ( ) const [inline]

Parton shower cut-off mass for pure QED branchings.

Assumed <= Q0CHGQ.

void Pythia7::SpaceShowerHandler::persistentOutput ( PersistentOStream & os ) const

Function used to write out object persistently.

Parameters:

os

the persistent output stream written to.

Reimplemented from ThePEG::Interfaced.

void Pythia7::SpaceShowerHandler::persistentInput	(	PersistentIStream &	is,
		int	version
	)

Function used to read in object persistently.

Parameters:

	is	the persistent input stream read from.
	version	the version number of the object when written.

Reimplemented from ThePEG::Interfaced.

virtual IBPtr Pythia7::SpaceShowerHandler::clone ( ) const [inline, protected, virtual]

Make a simple clone of this object.

Returns:: a pointer to the new object.

Implements ThePEG::InterfacedBase.

virtual IBPtr Pythia7::SpaceShowerHandler::fullclone ( ) const [inline, protected, virtual]

Make a clone of this object, possibly modifying the cloned object to make it sane.

Returns:: a pointer to the new object.

Reimplemented from ThePEG::InterfacedBase.

virtual void Pythia7::SpaceShowerHandler::doinit ( ) throw (InitException) [inline, protected, virtual]

Initialize this object after the setup phase before saving an EventGenerator to disk.

Exceptions:

InitException

if object could not be initialized properly.

Reimplemented from ThePEG::InterfacedBase.

virtual void Pythia7::SpaceShowerHandler::doinitrun ( ) [inline, protected, virtual]

Initialize this object.

Called in the run phase just before a run begins.

Reimplemented from ThePEG::InterfacedBase.

virtual void Pythia7::SpaceShowerHandler::dofinish ( ) [inline, protected, virtual]

Finalize this object.

Called in the run phase just after a run has ended. Used eg. to write out statistics.

Reimplemented from ThePEG::InterfacedBase.

virtual void Pythia7::SpaceShowerHandler::rebind ( const TranslationMap & trans ) throw (RebindException) [inline, protected, virtual]

Rebind pointer to other Interfaced objects.

Called in the setup phase after all objects used in an EventGenerator has been cloned so that the pointers will refer to the cloned objects afterwards.

Parameters:

trans

a TranslationMap relating the original objects to their respective clones.

Exceptions:

RebindException

if no cloned object was found for a given pointer.

Reimplemented from ThePEG::InterfacedBase.

virtual IVector Pythia7::SpaceShowerHandler::getReferences ( ) [inline, protected, virtual]

Return a vector of all pointers to Interfaced objects used in this object.

Returns:: a vector of pointers.

Reimplemented from ThePEG::InterfacedBase.

Member Data Documentation

int Pythia7::SpaceShowerHandler::theAlphaSMode [private]

Running of alpha_strong in evolution: = 0: fixed; = 1: scale Q^2; = 2: scale pT^2.

But note that PDF's are always evaluated at Q2.

Definition at line 360 of file SpaceShowerHandler.h.

int Pythia7::SpaceShowerHandler::theFinalCone [private]

Restrict first emission within cone given by colour flow in hard process.

= 0: no; = 1: yes, isotropic phi angle inside cone; = 2: yes, also with anisotropic phi angle inside cone.

Definition at line 384 of file SpaceShowerHandler.h.

int Pythia7::SpaceShowerHandler::theQ2Order [private]

Q2 ordering is normal, but could be relaxed (to be developed in future).

= 0: yes; = 1: no, allow maximum kinematically possible (toy scenario).

Definition at line 391 of file SpaceShowerHandler.h.

int Pythia7::SpaceShowerHandler::thePhiPolAsym [private]

Azimuthal asymmetry induced by gluon polarization.

= 0: no; = 1: yes.

Definition at line 402 of file SpaceShowerHandler.h.

int Pythia7::SpaceShowerHandler::thePhiCoherAsym [private]

Azimuthal asymmetry induced by colour coherence.

= 0: no; = 1: yes.

Definition at line 408 of file SpaceShowerHandler.h.

int Pythia7::SpaceShowerHandler::theRespectScale [private]

Use the scale variable of original partons to restrict branchings.

= 0: no; = 1: yes, the Q2 < scale; = 2: yes, the pT2 < scale, = 3: yes, the (E*theta)^2 < scale; = 4: yes, the theta^2 < scale. Here theta is the full opening angle of a branching, defined in the rest frame of the event. (In all cases relations are approximate.)

Definition at line 418 of file SpaceShowerHandler.h.

Energy Pythia7::SpaceShowerHandler::theQ0ChgL [private]

Parton shower cut-off mass for pure QED branchings.

Assumed <= Q0CHGQ.

Definition at line 433 of file SpaceShowerHandler.h.

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

SpaceShowerHandler.h


Public Member Functions
Shower::SpaceShower *	getModel ()
	Set the static parameters of the underlying model object and return an instance.
int	hadronShower () const
	Allowed ISR showers for incoming hadron: = 0: none; = 1: QCD ones; = 2 : also allow photon emission; = 3 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).
int	leptonShower () const
	Allowed ISR showers for incoming lepton: = 0: none; = 1: photon emission; = 2 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).
int	nQuarks () const
	Number of allowed quark flavours in $g\rightarrow q \bar{q}$ branching.
int	alphaSMode () const
	Running of alpha_strong in evolution: = 0: fixed; = 1: scale ; = 2: scale $p_\perp^2$ .
int	maxVirtuality () const
	Maximum virtuality setting the starting point of the evolution: = 0: ; = 1: $\hat{s}$ ; = 2: average $m_\perp^2$ ; = 3: smallest $m_\perp^2$ .
int	MEMode () const
	Use of matrix element corrections: = 0: no; = 1: yes.
int	softGluonResum () const
	Resum the effect of multiple soft gluon emissions: = 0: no; = 1: yes.
int	finalCone () const
	Restrict first emission within cone given by colour flow in hard process.
int	Q2Order () const
	Q2 ordering is normal, but could be relaxed (to be developed in future).
bool	angularOrdering () const
	Use angular ordering?
int	phiPolAsym () const
	Azimuthal asymmetry induced by gluon polarization.
int	phiCoherAsym () const
	Azimuthal asymmetry induced by colour coherence.
int	respectScale () const
	Use the scale variable of original partons to restrict branchings.
Energy	Q0 () const
	Parton shower cut-off mass for QCD emissions.
Energy	Q0ChgQ () const
	Parton shower cut-off mass for photon coupling to coloured particle.
Energy	Q0ChgL () const
	Parton shower cut-off mass for pure QED branchings.
double	alphaSFix () const
	Fixed alpha_strong value for AlphaSMode == 0.
Energy	Lambda5 () const
	Lambda_QCD(five flavours) in alpha_strong for AlphaSMode >= 1.
double	alphaEMFix () const
	Fixed alpha_em value.
Energy	EMinEmitted () const
	Minimum energy of emitted QCD parton in rest frame of subprocess.
double	zMinEmitted () const
	Minimum fraction of emitted QCD parton, in addition to other limits.
double	xMinEmittedChg () const
	Minimum fraction of emitted photon - matched to treatment of photon PDF.
Energy	tinyQChg () const
	Smallest particle mass for QED evolution (= electron mass).
double	tinyPDF () const
	Vanishingly small parton density.
double	tinyKernelPDF () const
	Vanishingly small product of splitting kernels and parton density ratios.
double	tinyKinPrec () const
	Vanishingly small recoil mass in branching kinematics reconstruction.
double	heavyEvol () const
	Safety margin in that heavy flavour evolution is at all possible.
double	extraPreweight () const
	Extra preweight in QED shower evolution, to avoid maximum violation.
double	heavyMax () const
	Maximum allowed when reconstructing back to heavy flavour from gluon or photon.
double	Q2StartFrac () const
	Mimimum gap in values to allow iteration when parton density vanishes.
Standard constructors and destructors.
	SpaceShowerHandler ()
	The default constructor.
	SpaceShowerHandler (const SpaceShowerHandler &)
	The copy constructor.
virtual	~SpaceShowerHandler ()
	The destructor.
Functions used by the persistent I/O system.
void	persistentOutput (PersistentOStream &os) const
	Function used to write out object persistently.
void	persistentInput (PersistentIStream &is, int version)
	Function used to read in object persistently.
Static Public Member Functions
static void	Init ()
	Standard Init function used to initialize the interfaces.
Protected Member Functions
Clone Methods.
virtual IBPtr	clone () const
	Make a simple clone of this object.
virtual IBPtr	fullclone () const
	Make a clone of this object, possibly modifying the cloned object to make it sane.
Standard Interfaced functions.
virtual void	doupdate () throw (UpdateException)
	Check sanity of the object during the setup phase.
virtual void	doinit () throw (InitException)
	Initialize this object after the setup phase before saving an EventGenerator to disk.
virtual void	doinitrun ()
	Initialize this object.
virtual void	dofinish ()
	Finalize this object.
virtual void	rebind (const TranslationMap &trans) throw (RebindException)
	Rebind pointer to other Interfaced objects.
virtual IVector	getReferences ()
	Return a vector of all pointers to Interfaced objects used in this object.
Private Member Functions
SpaceShowerHandler &	operator= (const SpaceShowerHandler &)
	Private and non-existent assignment operator.
Private Attributes
Shower::SpaceShower *	theShowerModel
	The object implementing the actual model.
int	theHadronShower
	Allowed ISR showers for incoming hadron: = 0: none; = 1: QCD ones; = 2 : also allow photon emission; = 3 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).
int	theLeptonShower
	Allowed ISR showers for incoming lepton: = 0: none; = 1: photon emission; = 2 : allow spacelike photon branchings, if supported by the PDF used (not the case currently) (does not address VMD part of resolved photons).
int	theNQuarks
	Number of allowed quark flavours in g -> q qbar branching.
int	theAlphaSMode
	Running of alpha_strong in evolution: = 0: fixed; = 1: scale Q^2; = 2: scale pT^2.
int	theMaxVirtuality
	Maximum virtuality setting the starting point of the evolution: = 0: s; = 1: sHat; = 2: average mT^2; = 3: smallest mT^2.
int	theMEMode
	Use of matrix element corrections: = 0: no; = 1: yes.
int	theSoftGluonResum
	Resum the effect of multiple soft gluon emissions: = 0: no; = 1: yes.
int	theFinalCone
	Restrict first emission within cone given by colour flow in hard process.
int	theQ2Order
	Q2 ordering is normal, but could be relaxed (to be developed in future).
int	useAngularOrdering
	Use angular ordering if non-zero.
int	thePhiPolAsym
	Azimuthal asymmetry induced by gluon polarization.
int	thePhiCoherAsym
	Azimuthal asymmetry induced by colour coherence.
int	theRespectScale
	Use the scale variable of original partons to restrict branchings.
Energy	theQ0
	Parton shower cut-off mass for QCD emissions.
Energy	theQ0ChgQ
	Parton shower cut-off mass for photon coupling to coloured particle.
Energy	theQ0ChgL
	Parton shower cut-off mass for pure QED branchings.
double	theAlphaSFix
	Fixed alpha_strong value for AlphaSMode == 0.
Energy	theLambda5
	Lambda_QCD(five flavours) in alpha_strong for AlphaSMode >= 1.
double	theAlphaEMFix
	Fixed alpha_em value.
Energy	theEMinEmitted
	Minimum energy of emitted QCD parton in rest frame of subprocess.
double	theZMinEmitted
	Minimum fraction 1 - z of emitted QCD parton, in addition to other limits.
double	theXMinEmittedChg
	Minimum x fraction of emitted photon - matched to treatment of photon PDF.
Energy	theTinyQChg
	Smallest particle mass for QED evolution (= electron mass).
double	theTinyPDF
	Vanishingly small parton density.
double	theTinyKernelPDF
	Vanishingly small product of splitting kernels and parton density ratios.
double	theTinyKinPrec
	Vanishingly small recoil mass in branching kinematics reconstruction.
double	theHeavyEvol
	Safety margin in x that heavy flavour evolution is at all possible.
double	theExtraPreweight
	Extra preweight in QED shower evolution, to avoid maximum violation.
double	theHeavyMax
	Maximum allowed x when reconstructing back to heavy flavour from gluon or photon.
double	theQ2StartFrac
	Mimimum gap in Q2 values to allow iteration when parton density vanishes.
Static Private Attributes
static ClassDescription < SpaceShowerHandler >	initSpaceShowerHandler
	Describe a concrete class with persistent data.