herwig is hosted by Hepforge, IPPP Durham
Herwig 7.3.0
Herwig::GeneralFourBodyDecayer Class Reference

Here is the documentation of the GeneralFourBodyDecayer class. More...

#include <GeneralFourBodyDecayer.h>

Inheritance diagram for Herwig::GeneralFourBodyDecayer:

Public Member Functions

 GeneralFourBodyDecayer ()
 The default constructor.
 
Virtual functions required by the Decayer class.
virtual ParticleVector decay (const Particle &parent, const tPDVector &children) const
 For a given decay mode and a given particle instance, perform the decay and return the decay products.
 
virtual int modeNumber (bool &cc, tcPDPtr parent, const tPDVector &children) const
 Which of the possible decays is required.
 
bool setDecayInfo (PDPtr incoming, vector< PDPtr > outgoing, const vector< NBDiagram > &process, double symfac)
 Set the diagrams.
 
virtual Energy partialWidth (tPDPtr inpart, OrderedParticles outgoing) const
 Function to return partial Width.
 
- Public Member Functions inherited from Herwig::DecayIntegrator
 DecayIntegrator ()
 The default constructor.
 
virtual bool accept (tcPDPtr parent, const tPDVector &children) const
 Check if this decayer can perfom the decay for a particular mode.
 
virtual ParticleVector decay (const Particle &parent, const tPDVector &children) const
 For a given decay mode and a given particle instance, perform the decay and return the decay products.
 
virtual int modeNumber (bool &cc, tcPDPtr parent, const tPDVector &children) const =0
 Which of the possible decays is required.
 
int imode () const
 The mode being used for this decay.
 
void addMode (PhaseSpaceModePtr mode) const
 Add a phase-space mode to the list.
 
virtual double me2 (const int ichan, const Particle &part, const tPDVector &outgoing, const vector< Lorentz5Momentum > &momenta, MEOption meopt) const =0
 Return the matrix element squared for a given mode and phase-space channel.
 
virtual void constructSpinInfo (const Particle &part, ParticleVector outgoing) const =0
 Construct the SpinInfos for the particles produced in the decay.
 
virtual void dataBaseOutput (ofstream &os, bool header) const
 Output the setup information for the particle database.
 
void setPartialWidth (const DecayMode &dm, int imode)
 Set the code for the partial width.
 
virtual bool twoBodyMEcode (const DecayMode &, int &mecode, double &coupling) const
 Specify the \(1\to2\) matrix element to be used in the running width calculation.
 
virtual WidthCalculatorBasePtr threeBodyMEIntegrator (const DecayMode &dm) const
 Method to return an object to calculate the 3 (or higher body) partial width.
 
virtual double threeBodyMatrixElement (const int imode, const Energy2 q2, const Energy2 s3, const Energy2 s2, const Energy2 s1, const Energy m1, const Energy m2, const Energy m3) const
 The matrix element to be integrated for the three-body decays as a function of the invariant masses of pairs of the outgoing particles.
 
virtual InvEnergy threeBodydGammads (const int imode, const Energy2 q2, const Energy2 s, const Energy m1, const Energy m2, const Energy m3) const
 The differential three body decay rate with one integral performed.
 
int findMode (const DecayMode &dm)
 Finds the phase-space mode corresponding to a given decay mode.
 
ParticleVector generatePhotons (const Particle &p, ParticleVector children)
 Members for the generation of QED radiation in the decays.
 
bool canGeneratePhotons ()
 check if photons can be generated in the decay
 
virtual double oneLoopVirtualME (unsigned int imode, const Particle &part, const ParticleVector &products)
 The one-loop virtual correction.
 
bool hasOneLoopME ()
 Whether or not the one loop matrix element is implemented.
 
virtual InvEnergy2 realEmissionME (unsigned int imode, const Particle &part, ParticleVector &products, unsigned int iemitter, double ctheta, double stheta, const LorentzRotation &rot1, const LorentzRotation &rot2)
 The real emission matrix element.
 
bool hasRealEmissionME ()
 Whether or not the real emission matrix element is implemented.
 
bool warnings () const
 
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.
 
- Public Member Functions inherited from Herwig::HwDecayerBase
 HwDecayerBase ()
 The default constructor.
 
virtual bool accept (const DecayMode &dm) const
 Check if this decayer can perfom the decay specified by the given decay mode.
 
virtual ParticleVector decay (const DecayMode &dm, const Particle &p) const
 Perform a decay for a given DecayMode and a given Particle instance.
 
virtual POWHEGType hasPOWHEGCorrection ()
 Has a POWHEG style correction.
 
virtual bool hasMECorrection ()
 Has an old fashioned ME correction.
 
virtual void initializeMECorrection (RealEmissionProcessPtr, double &, double &)
 Initialize the ME correction.
 
virtual RealEmissionProcessPtr applyHardMatrixElementCorrection (RealEmissionProcessPtr)
 Apply the hard matrix element correction to a given hard process or decay.
 
virtual bool softMatrixElementVeto (PPtr parent, PPtr progenitor, const bool &fs, const Energy &highestpT, const vector< tcPDPtr > &ids, const double &z, const Energy &scale, const Energy &pT)
 Apply the soft matrix element correction.
 
virtual RealEmissionProcessPtr generateHardest (RealEmissionProcessPtr)
 Apply the POWHEG style correction.
 
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.
 
bool initialize () const
 Access to the initialize variable.
 
bool databaseOutput () const
 Access the database output variable.
 
- Public Member Functions inherited from ThePEG::Decayer
void persistentOutput (PersistentOStream &os) const
 
void persistentInput (PersistentIStream &is, int version)
 
virtual bool accept (const DecayMode &dm) const=0
 
virtual bool needsFullStep () const
 
virtual ParticleVector decay (const DecayMode &dm, const Particle &p) const=0
 
virtual ParticleVector decay (const DecayMode &dm, const Particle &p, Step &step) const
 
virtual double brat (const DecayMode &dm, const ParticleData &pd, double oldbrat) const
 
virtual double brat (const DecayMode &dm, const Particle &p, double oldbrat) const
 
virtual ParticleVector getChildren (const DecayMode &dm, const Particle &parent) const
 
virtual void finalBoost (const Particle &parent, const ParticleVector &children) const
 
virtual void setScales (const Particle &parent, const ParticleVector &children) const
 
Ptr< Amplitude >::pointer amplitude () const
 
- Public Member Functions inherited from ThePEG::HandlerBaseT< UseRandom >
double rnd () const
 
double rnd (double xu) const
 
double rnd (double xl, double xu) const
 
bool rndbool () const
 
bool rndbool (double p) const
 
bool rndbool (double p1, double p2) const
 
int rndsign (double p1, double p2, double p3) const
 
int rnd2 (double p0, double p1) const
 
int rnd3 (double p0, double p1, double p2) const
 
int rnd4 (double p0, double p1, double p2, double p3) const
 
long irnd (long xu=2) const
 
long irnd (long xl, long xu) const
 
const StandardModelBaseSM () const
 
tSMPtr standardModel () const
 
- Public Member Functions inherited from ThePEG::Interfaced
virtual bool defaultInit ()
 
PPtr getParticle (PID) const
 
PDPtr getParticleData (PID) const
 
bool used () const
 
void useMe () const
 
tEGPtr generator () const
 
void persistentOutput (PersistentOStream &os) const
 
void persistentInput (PersistentIStream &is, int version)
 
PPtr getParticle (PID) const
 
PDPtr getParticleData (PID) const
 
bool used () const
 
void useMe () const
 
tEGPtr generator () const
 
- Public Member Functions inherited from ThePEG::InterfacedBase
string fullName () const
 
string name () const
 
string path () const
 
string comment () const
 
void setup (istream &is)
 
void update ()
 
void init ()
 
virtual bool preInitialize () const
 
void initrun ()
 
void finish ()
 
void touch ()
 
void reset ()
 
void clear ()
 
InitState state () const
 
bool locked () const
 
bool touched () const
 
virtual IBPtr fullclone () const
 
void persistentOutput (PersistentOStream &os) const
 
void persistentInput (PersistentIStream &is, int version)
 
virtual void debugme () const
 
void update ()
 
void init ()
 
virtual bool preInitialize () const
 
void initrun ()
 
void finish ()
 
void touch ()
 
void reset ()
 
void clear ()
 
InitState state () const
 
bool locked () const
 
bool touched () const
 
virtual IBPtr fullclone () const
 
- Public Member Functions inherited from ThePEG::Base
void debug () const
 
virtual void debugme () const
 
- Public Member Functions inherited from ThePEG::Pointer::ReferenceCounted
CounterType referenceCount () const
 
- Public Member Functions inherited from ThePEG::Named
 Named (const string &newName=string())
 
 Named (const Named &)=default
 
const string & name () const
 
bool operator== (const Named &other) const
 
bool operator< (const Named &other) const
 

Standard Interfaced functions.

PDPtr incoming_
 Store the incoming particle.
 
tPDVector outgoing_
 Outgoing particles.
 
vector< NBDiagramdiagrams_
 Store the diagrams for the decay.
 
vector< unsigned int > diagmap_
 Map between the diagrams and the phase-space channels.
 
vector< DVectorcolour_
 Store colour factors for ME calc.
 
vector< DVectorcolourLargeNC_
 Store cololur factors for ME calc at large N_c.
 
unsigned int nflow_
 The number of colourflows.
 
unsigned int widthOpt_
 Option for the treatment of the widths.
 
string refTag_
 Store a decay tag for this mode that can be tested when trying to determine whether it can be generated by this Decayer.
 
string refTagCC_
 Store a decay tag for the cc-mode that can be tested when trying to determine whether it can be generated by this Decayer.
 
unsigned int iflow_
 The colour flow.
 
virtual void doinit ()
 Initialize this object after the setup phase before saving an EventGenerator to disk.
 
GeneralFourBodyDecayeroperator= (const GeneralFourBodyDecayer &)=delete
 The assignment operator is private and must never be called.
 

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 void Init ()
 The standard Init function used to initialize the interfaces.
 
PDPtr incoming () const
 Incoming particle.
 
const tPDVectoroutgoing () const
 Outgoing particles.
 
unsigned int numberOfFlows () const
 Number of colour flows.
 
bool setColourFactors (double symfac)
 Set up the colour factors.
 
const vector< DVector > & getColourFactors () const
 Return the matrix of colour factors.
 
const vector< DVector > & getLargeNcColourFactors () const
 Return the matrix of colour factors.
 
unsigned int widthOption () const
 Option for the handling of the widths of the intermediate particles.
 
void colourConnections (const Particle &parent, const ParticleVector &out) const
 Set colour connections.
 
void colourFlow (unsigned int flow) const
 Set the colour flow.
 
unsigned int const & colourFlow () const
 Set the colour flow.
 
const vector< NBDiagram > & getProcessInfo () const
 Access the TBDiagrams that store the required information to create the diagrams.
 
const vector< unsigned int > & diagramMap () const
 Get the mapping between the phase-space channel and the diagram.
 

Additional Inherited Members

- Public Types inherited from Herwig::DecayIntegrator
enum  MEOption { Initialize , Calculate , Terminate }
 Enum for the matrix element option. More...
 
- Public Types inherited from Herwig::HwDecayerBase
enum  POWHEGType { No , ISR , FSR , Both }
 Virtual members to be overridden by inheriting classes which implement hard corrections. More...
 
- Public Types inherited from ThePEG::InterfacedBase
enum  InitState
 
- Public Types inherited from ThePEG::Pointer::ReferenceCounted
typedef unsigned int CounterType
 
- Static Public Member Functions inherited from Herwig::DecayIntegrator
static void Init ()
 The standard Init function used to initialize the interfaces.
 
- Static Public Member Functions inherited from Herwig::HwDecayerBase
static void Init ()
 The standard Init function used to initialize the interfaces.
 
- Static Public Member Functions inherited from ThePEG::Decayer
static void Init ()
 
static ParticleVector DecayParticle (tPPtr parent, Step &step, long maxtry=1000)
 
- Static Public Member Functions inherited from ThePEG::HandlerBase
static void Init ()
 
- Static Public Member Functions inherited from ThePEG::Interfaced
static void Init ()
 
- Static Public Member Functions inherited from ThePEG::InterfacedBase
static void Init ()
 
- Static Public Member Functions inherited from ThePEG::Base
static void Init ()
 
- Public Attributes inherited from ThePEG::InterfacedBase
 initializing
 
 uninitialized
 
 initialized
 
 runready
 
- Public Attributes inherited from ThePEG::Pointer::ReferenceCounted
const unsigned long uniqueId
 
- Protected Member Functions inherited from Herwig::DecayIntegrator
virtual void doinitrun ()
 Initialize this object.
 
ParticleVector generate (bool inter, bool cc, const unsigned int &imode, const Particle &inpart) const
 Generate the momenta for the decay.
 
void imode (int in)
 Set the mode being use for this decay.
 
void ME (DecayMEPtr in) const
 Set the helicity matrix element for the decay.
 
DecayMEPtr ME () const
 The helicity amplitude matrix element for spin correlations.
 
void resetIntermediate (tcPDPtr part, Energy mass, Energy width)
 Reset the properities of all intermediates.
 
Energy initializePhaseSpaceMode (unsigned int imode, bool init, bool onShell=false) const
 Initialize the phase-space mode.
 
void generateIntermediates (bool in)
 Methods to set variables in inheriting classes.
 
bool generateIntermediates () const
 Set whether or not the intermediates are included.
 
void hasOneLoopME (bool in)
 Whether or not the one loop matrix element is implemented.
 
void hasRealEmissionME (bool in)
 Whether or not the real emission matrix element is implemented.
 
void epsilonPS (Energy in)
 Set the epsilon parameter.
 
void clearModes ()
 Clear the models.
 
unsigned int numberModes () const
 Number of decay modes.
 
tPhaseSpaceModePtr mode (unsigned int ix)
 Pointer to a mode.
 
tcPhaseSpaceModePtr mode (unsigned int ix) const
 Pointer to a mode.
 
- Protected Member Functions inherited from Herwig::HwDecayerBase
virtual void dofinish ()
 Finalize this object.
 
void fixRho (RhoDMatrix &) const
 Set rho to be diagonal if no correlations.
 
- Protected Member Functions inherited from ThePEG::Interfaced
void reporeg (IBPtr object, string name) const
 
bool setDefaultReference (PtrT &ptr, string classname, string objectname)
 
 Interfaced (const string &newName)
 
 Interfaced (const Interfaced &i)
 
void setGenerator (tEGPtr generator)
 
- Protected Member Functions inherited from ThePEG::InterfacedBase
virtual void readSetup (istream &is)
 
virtual void doupdate ()
 
virtual void doinit ()
 
virtual void doinitrun ()
 
virtual void dofinish ()
 
virtual IVector getReferences ()
 
virtual void rebind (const TranslationMap &)
 
virtual IBPtr clone () const=0
 
 InterfacedBase (string newName)
 
 InterfacedBase (const InterfacedBase &i)
 
virtual void readSetup (istream &is)
 
virtual void doupdate ()
 
virtual void doinit ()
 
virtual void doinitrun ()
 
virtual void dofinish ()
 
virtual IVector getReferences ()
 
virtual void rebind (const TranslationMap &)
 
- Protected Member Functions inherited from ThePEG::Pointer::ReferenceCounted
 ReferenceCounted (const ReferenceCounted &)
 
ReferenceCountedoperator= (const ReferenceCounted &)
 
- Protected Member Functions inherited from ThePEG::Named
const Namedoperator= (const Named &other)
 
const string & name (const string &newName)
 
- Static Protected Member Functions inherited from ThePEG::Interfaced
static void registerRepository (IBPtr)
 
static void registerRepository (IBPtr, string newName)
 

Detailed Description

Here is the documentation of the GeneralFourBodyDecayer class.

See also
The interfaces defined for GeneralFourBodyDecayer.

Definition at line 21 of file GeneralFourBodyDecayer.h.

Constructor & Destructor Documentation

◆ GeneralFourBodyDecayer()

Herwig::GeneralFourBodyDecayer::GeneralFourBodyDecayer ( )
inline

The default constructor.

Definition at line 28 of file GeneralFourBodyDecayer.h.

Member Function Documentation

◆ colourConnections()

void Herwig::GeneralFourBodyDecayer::colourConnections ( const Particle parent,
const ParticleVector out 
) const
protected

Set colour connections.

Parameters
parentParent particle
outParticle vector containing particles to connect colour lines

◆ colourFlow() [1/2]

unsigned int const & Herwig::GeneralFourBodyDecayer::colourFlow ( ) const
inlineprotected

Set the colour flow.

Definition at line 151 of file GeneralFourBodyDecayer.h.

References iflow_.

◆ colourFlow() [2/2]

void Herwig::GeneralFourBodyDecayer::colourFlow ( unsigned int  flow) const
inlineprotected

Set the colour flow.

Parameters
flowThe value for the colour flow

Definition at line 146 of file GeneralFourBodyDecayer.h.

References iflow_.

◆ decay()

virtual ParticleVector Herwig::GeneralFourBodyDecayer::decay ( const Particle parent,
const tPDVector children 
) const
virtual

For a given decay mode and a given particle instance, perform the decay and return the decay products.

As this is the base class this is not implemented.

Returns
The vector of particles produced in the decay.

Reimplemented from Herwig::DecayIntegrator.

◆ diagramMap()

const vector< unsigned int > & Herwig::GeneralFourBodyDecayer::diagramMap ( ) const
inlineprotected

Get the mapping between the phase-space channel and the diagram.

Definition at line 164 of file GeneralFourBodyDecayer.h.

References diagmap_.

◆ doinit()

virtual void Herwig::GeneralFourBodyDecayer::doinit ( )
protectedvirtual

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

Exceptions
InitExceptionif object could not be initialized properly.

Reimplemented from ThePEG::InterfacedBase.

Reimplemented in Herwig::StoFFFFDecayer.

◆ getColourFactors()

const vector< DVector > & Herwig::GeneralFourBodyDecayer::getColourFactors ( ) const
inlineprotected

Return the matrix of colour factors.

Definition at line 119 of file GeneralFourBodyDecayer.h.

References colour_.

◆ getLargeNcColourFactors()

const vector< DVector > & Herwig::GeneralFourBodyDecayer::getLargeNcColourFactors ( ) const
inlineprotected

Return the matrix of colour factors.

Definition at line 124 of file GeneralFourBodyDecayer.h.

References colourLargeNC_.

◆ getProcessInfo()

const vector< NBDiagram > & Herwig::GeneralFourBodyDecayer::getProcessInfo ( ) const
inlineprotected

Access the TBDiagrams that store the required information to create the diagrams.

Definition at line 157 of file GeneralFourBodyDecayer.h.

References diagrams_.

◆ incoming()

PDPtr Herwig::GeneralFourBodyDecayer::incoming ( ) const
inlineprotected

Incoming particle.

Definition at line 99 of file GeneralFourBodyDecayer.h.

References incoming_.

◆ Init()

static void Herwig::GeneralFourBodyDecayer::Init ( )
static

The standard Init function used to initialize the interfaces.

Called exactly once for each class by the class description system before the main function starts or when this class is dynamically loaded.

◆ modeNumber()

virtual int Herwig::GeneralFourBodyDecayer::modeNumber ( bool &  cc,
tcPDPtr  parent,
const tPDVector children 
) const
virtual

Which of the possible decays is required.

Parameters
ccIs this mode the charge conjugate
parentThe decaying particle
childrenThe decay products

Implements Herwig::DecayIntegrator.

◆ numberOfFlows()

unsigned int Herwig::GeneralFourBodyDecayer::numberOfFlows ( ) const
inlineprotected

Number of colour flows.

Definition at line 109 of file GeneralFourBodyDecayer.h.

References nflow_.

◆ operator=()

GeneralFourBodyDecayer & Herwig::GeneralFourBodyDecayer::operator= ( const GeneralFourBodyDecayer )
privatedelete

The assignment operator is private and must never be called.

In fact, it should not even be implemented.

◆ outgoing()

const tPDVector & Herwig::GeneralFourBodyDecayer::outgoing ( ) const
inlineprotected

Outgoing particles.

Definition at line 104 of file GeneralFourBodyDecayer.h.

References outgoing_.

◆ partialWidth()

virtual Energy Herwig::GeneralFourBodyDecayer::partialWidth ( tPDPtr  inpart,
OrderedParticles  outgoing 
) const
virtual

Function to return partial Width.

Parameters
inpartPointer to incoming particle data object
outgoingthe decay products

◆ persistentInput()

void Herwig::GeneralFourBodyDecayer::persistentInput ( PersistentIStream is,
int  version 
)

Function used to read in object persistently.

Parameters
isthe persistent input stream read from.
versionthe version number of the object when written.

◆ persistentOutput()

void Herwig::GeneralFourBodyDecayer::persistentOutput ( PersistentOStream os) const

Function used to write out object persistently.

Parameters
osthe persistent output stream written to.

◆ widthOption()

unsigned int Herwig::GeneralFourBodyDecayer::widthOption ( ) const
inlineprotected

Option for the handling of the widths of the intermediate particles.

Definition at line 131 of file GeneralFourBodyDecayer.h.

References widthOpt_.

Member Data Documentation

◆ colour_

vector<DVector> Herwig::GeneralFourBodyDecayer::colour_
private

Store colour factors for ME calc.

Definition at line 213 of file GeneralFourBodyDecayer.h.

Referenced by getColourFactors().

◆ colourLargeNC_

vector<DVector> Herwig::GeneralFourBodyDecayer::colourLargeNC_
private

Store cololur factors for ME calc at large N_c.

Definition at line 218 of file GeneralFourBodyDecayer.h.

Referenced by getLargeNcColourFactors().

◆ diagmap_

vector<unsigned int> Herwig::GeneralFourBodyDecayer::diagmap_
private

Map between the diagrams and the phase-space channels.

Definition at line 208 of file GeneralFourBodyDecayer.h.

Referenced by diagramMap().

◆ diagrams_

vector<NBDiagram> Herwig::GeneralFourBodyDecayer::diagrams_
private

Store the diagrams for the decay.

Definition at line 203 of file GeneralFourBodyDecayer.h.

Referenced by getProcessInfo().

◆ iflow_

unsigned int Herwig::GeneralFourBodyDecayer::iflow_
mutableprivate

The colour flow.

Definition at line 247 of file GeneralFourBodyDecayer.h.

Referenced by colourFlow().

◆ incoming_

PDPtr Herwig::GeneralFourBodyDecayer::incoming_
private

Store the incoming particle.

Definition at line 193 of file GeneralFourBodyDecayer.h.

Referenced by incoming().

◆ nflow_

unsigned int Herwig::GeneralFourBodyDecayer::nflow_
private

The number of colourflows.

Definition at line 223 of file GeneralFourBodyDecayer.h.

Referenced by numberOfFlows().

◆ outgoing_

tPDVector Herwig::GeneralFourBodyDecayer::outgoing_
private

Outgoing particles.

Definition at line 198 of file GeneralFourBodyDecayer.h.

Referenced by outgoing().

◆ refTag_

string Herwig::GeneralFourBodyDecayer::refTag_
private

Store a decay tag for this mode that can be tested when trying to determine whether it can be generated by this Decayer.

Definition at line 235 of file GeneralFourBodyDecayer.h.

◆ refTagCC_

string Herwig::GeneralFourBodyDecayer::refTagCC_
private

Store a decay tag for the cc-mode that can be tested when trying to determine whether it can be generated by this Decayer.

Definition at line 242 of file GeneralFourBodyDecayer.h.

◆ widthOpt_

unsigned int Herwig::GeneralFourBodyDecayer::widthOpt_
private

Option for the treatment of the widths.

Definition at line 228 of file GeneralFourBodyDecayer.h.

Referenced by widthOption().


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