ThePEG 2.3.0
|
The VertexBase class is the base class for all helicity amplitude vertices. More...
#include <VertexBase.h>
Public Member Functions | |
Standard constructors and destructors. | |
VertexBase (VertexType::T name, bool kine=false) | |
Constructor for \(n\)-point vertices. | |
Calculation of the strong, electromagnetic and weak couplings | |
double | strongCoupling (Energy2 q2) const |
Strong coupling. | |
double | electroMagneticCoupling (Energy2 q2) const |
Electromagnetic coupling. | |
double | weakCoupling (Energy2 q2) const |
Weak coupling. | |
double | sin2ThetaW () const |
virtual void | setCoupling (Energy2 q2, tcPDPtr part1, tcPDPtr part2, tcPDPtr part3)=0 |
Set coupling methods. | |
virtual void | setCoupling (Energy2 q2, tcPDPtr part1, tcPDPtr part2, tcPDPtr part3, tcPDPtr part4)=0 |
Calculate the couplings for a four point interaction. | |
Public Member Functions inherited from ThePEG::Interfaced | |
virtual | ~Interfaced () |
Empty virtual destructor. | |
virtual bool | defaultInit () |
Functions which are to be used during the actual event generation, after the setup is complete. | |
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. | |
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 ThePEG::InterfacedBase | |
virtual | ~InterfacedBase () |
The virtual (empty) destructor;. | |
string | fullName () const |
Returns the full name of this object including its path, e.g. | |
string | name () const |
Returns the name of this object, without the path. | |
string | path () const |
Returns the path to this object including the trailing '/'. | |
string | comment () const |
Returns a comment assigned to this object. | |
void | setup (istream &is) |
Read setup info from a standard istream is. | |
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). | |
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(). | |
virtual IBPtr | fullclone () const |
Return a full clone of this object possibly doing things to the clone to make it sane. | |
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. | |
virtual void | debugme () const |
Print out debugging information for this object on std::cerr. | |
Public Member Functions inherited from ThePEG::Base | |
virtual | ~Base () |
The virtual destructor. | |
void | debug () const |
Print out debugging information for this object on std::cerr. | |
virtual void | debugme () const |
Print out debugging information for this object on std::cerr. | |
Public Member Functions inherited from ThePEG::Pointer::ReferenceCounted | |
CounterType | referenceCount () const |
Return the reference count. | |
Public Member Functions inherited from ThePEG::Named | |
Named (const string &newName=string()) | |
Constructor with name. | |
Named (const Named &)=default | |
Explicit default copy-constructor (too avoid compiler warnings) | |
const string & | name () const |
Return name. | |
bool | operator== (const Named &other) const |
Test for equality. | |
bool | operator< (const Named &other) const |
Lexicographical comparison. | |
Protected Member Functions | |
Standard Interfaced functions. | |
virtual void | doinit () |
Initialize this object after the setup phase before saving an EventGenerator to disk. | |
virtual void | rebind (const TranslationMap &trans) |
Rebind pointer to other Interfaced objects. | |
virtual IVector | getReferences () |
Return a vector of all pointers to Interfaced objects used in this object. | |
void | addToList (const vector< long > &ids) |
Members to set-up the particles. | |
void | addToList (long ida, long idb, long idc, long idd=0) |
Set up the lists of outer particles for the three-/four-point vertex. | |
void | norm (const Complex &coup) |
Members for the amplitude calculations. | |
virtual Complex | propagator (int iopt, Energy2 q2, tcPDPtr part, complex< Energy > mass=-GeV, complex< Energy > width=-GeV) |
Calculate the propagator for a diagram. | |
Complex | normPropagator (int iopt, Energy2 q2, tcPDPtr part, complex< Energy > mass=-GeV, complex< Energy > width=-GeV) |
Calculate propagator multiplied by coupling. | |
Protected Member Functions inherited from ThePEG::Interfaced | |
void | reporeg (IBPtr object, string name) const |
Register the given object in the Repository with the given name in a subdirectory with the same name as this object. | |
template<typename PtrT > | |
bool | setDefaultReference (PtrT &ptr, string classname, string objectname) |
If the pointer, ptr, to an object is not set, create an object of class classname and register it with the Repository with the given objectname in a sib-directory with the same name as this object. | |
Interfaced () | |
Protected default constructor. | |
Interfaced (const string &newName) | |
Protected constructor taking a name as argument. | |
Interfaced (const Interfaced &i) | |
Protected copy-constructor. | |
void | setGenerator (tEGPtr generator) |
Protected function to reset the generator pointer, required for automatic decayer generation in Herwig++ BSM models. | |
Protected Member Functions inherited from ThePEG::InterfacedBase | |
virtual void | readSetup (istream &is) |
Read setup info from a standard istream is. | |
virtual void | doupdate () |
Check sanity of the object during the setup phase. | |
virtual void | doinitrun () |
Initialize this object. | |
virtual void | dofinish () |
Finalize this object. | |
virtual IBPtr | clone () const =0 |
Return a simple clone of this object. | |
InterfacedBase () | |
Protected default constructor. | |
InterfacedBase (string newName) | |
Protected constructor with the name given as argument. | |
InterfacedBase (const InterfacedBase &i) | |
Protected copy-constructor. | |
Protected Member Functions inherited from ThePEG::Pointer::ReferenceCounted | |
ReferenceCounted () | |
Default constructor. | |
ReferenceCounted (const ReferenceCounted &) | |
Copy-constructor. | |
ReferenceCounted & | operator= (const ReferenceCounted &) |
Assignment. | |
Protected Member Functions inherited from ThePEG::Named | |
const Named & | operator= (const Named &other) |
Assignment. | |
const string & | name (const string &newName) |
Set new name. | |
Friends | |
ostream & | operator<< (ostream &, const VertexBase &) |
The output operator is a friend to avoid the data being public. | |
Kinematic invariants for loop diagrams | |
vector< vector< PDPtr > > | _particles |
Storage of the particles. | |
unsigned int | _npoint |
Number of particles at the vertex. | |
set< tPDPtr > | _inpart |
ParticleData pointers for the allowed incoming particles. | |
set< tPDPtr > | _outpart |
ParticleData pointers for the allowed outgoing particles. | |
Complex | _norm |
The overall coupling. | |
bool | _calckinematics |
Whether or not to calculate the kinematic invariants for the vertex. | |
std::array< std::array< Energy2, 5 >, 5 > | _kine |
Kinematica quantities needed for loop vertices. | |
VertexType::T | _theName |
Name of vertex. | |
ColourStructure::T | colourStructure_ |
Colour structure of the vertex. | |
map< CouplingType::T, int > | couplingOrders_ |
The order of the vertex in specific couplings. | |
unsigned int | _coupopt |
option for the coupling | |
double | _gs |
Fixed value of strong coupling to use. | |
double | _ee |
Fixed value of the electromagentic coupling to use. | |
double | _sw |
Fixed value of \(\sin\theta_W\) to use. | |
bool | kinematics () const |
Whether or not to calculate the kinematics invariants. | |
void | kinematics (bool kine) |
Set whether or not to calculate the kinematics invariants. | |
void | calculateKinematics (const Lorentz5Momentum &p0, const Lorentz5Momentum &p1, const Lorentz5Momentum &p2) |
Calculate the kinematics for a 3-point vertex. | |
void | calculateKinematics (const Lorentz5Momentum &p0, const Lorentz5Momentum &p1, const Lorentz5Momentum &p2, const Lorentz5Momentum &p3) |
Calculate the kinematics for a 4-point vertex. | |
void | calculateKinematics (const vector< Lorentz5Momentum > &p) |
Calculate the kinematics for a n-point vertex. | |
Energy2 | invariant (unsigned int ix, unsigned int iy) const |
Get one of the kinematic invariants. | |
void | orderInGem (int order) |
Set the order in \(g_EM\). | |
void | orderInGs (int order) |
Set the order in \(g_s\). | |
void | orderInCoupling (CouplingType::T cType, int order) |
Set the order in a specifc type of coupling. | |
void | colourStructure (ColourStructure::T structure) |
Set the colour structure. | |
VertexBase & | operator= (const VertexBase &)=delete |
Private and non-existent assignment operator. | |
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. | |
unsigned int | size () const |
Access to the particle information. | |
bool | isIncoming (tPDPtr p) const |
Is a particle allowed as an incoming particle? | |
bool | isOutgoing (tPDPtr p) const |
Is a particle allowed as an outgoing particle? | |
const set< tPDPtr > & | incoming () const |
Get the list of incoming particles. | |
const set< tPDPtr > & | outgoing () const |
Get the list of outgoing particles. | |
Complex | norm () const |
Get the coupling. | |
vector< long > | search (unsigned int ilist, long id) const |
Function to search the list. | |
vector< tPDPtr > | search (unsigned int ilist, tcPDPtr id) const |
Function to search the list. | |
bool | allowed (long id1, long id2, long id3, long id4=0) const |
Is a given combination allowed. | |
VertexType::T | getName () const |
Get name of Vertex. | |
unsigned int | getNpoint () const |
Get number of lines on Vertex. | |
int | orderInGem () const |
Get the order in \(g_EM\). | |
int | orderInGs () const |
Get the order in \(g_s\). | |
int | orderInCoupling (CouplingType::T cType) const |
Get the order in a specific coupling. | |
int | orderInAllCouplings () const |
Get the total order of the vertex. | |
ColourStructure::T | colourStructure () const |
Get the colour structure. | |
static void | Init () |
Standard Init function used to initialize the interfaces. | |
Additional Inherited Members | |
Public Types inherited from ThePEG::InterfacedBase | |
enum | InitState { initializing = -1 , uninitialized = 0 , initialized = 1 , runready = 2 } |
Enumeration reflecting the state of an InterfacedBase object. More... | |
Public Types inherited from ThePEG::Pointer::ReferenceCounted | |
typedef unsigned int | CounterType |
The integer type used for counting. | |
Static Public Member Functions inherited from ThePEG::Interfaced | |
static void | Init () |
Standard Init function. | |
Static Public Member Functions inherited from ThePEG::InterfacedBase | |
static void | Init () |
Standard Init function. | |
Static Public Member Functions inherited from ThePEG::Base | |
static void | Init () |
The standard Init function used to initialize the interfaces. | |
Public Attributes inherited from ThePEG::Pointer::ReferenceCounted | |
const unsigned long | uniqueId |
The unique ID. | |
Static Protected Member Functions inherited from ThePEG::Interfaced | |
static void | registerRepository (IBPtr) |
Register an Interfaced object with the Repository. | |
static void | registerRepository (IBPtr, string newName) |
Register an Interfaced object with the Repository, giving it a name. | |
The VertexBase class is the base class for all helicity amplitude vertices.
In implements the storage of the particles which are allowed to interact at the vertex and some simple functions which are often needed by the classes which implement the specific vertices.
In practice little use is made of this information and it is mainly included for future extensions. It can also be used at the development and debugging stage.
Definition at line 83 of file VertexBase.h.
ThePEG::Helicity::VertexBase::VertexBase | ( | VertexType::T | name, |
bool | kine = false |
||
) |
Constructor for \(n\)-point vertices.
name | The type of vertex |
kine | Whether the kinematic invariants should be calculated. |
|
protected |
Members to set-up the particles.
Set up the lists of outer particles for the vertex.
ids | A vector of PDG codes for the particles. |
|
protected |
Set up the lists of outer particles for the three-/four-point vertex.
For small vertices, this form is much easier to use.
ida | The PDG codes for the first set of particles. |
idb | The PDG codes for the second set of particles. |
idc | The PDG codes for the third set of particles. |
idd | The PDG codes for the fourth set of particles. |
bool ThePEG::Helicity::VertexBase::allowed | ( | long | id1, |
long | id2, | ||
long | id3, | ||
long | id4 = 0 |
||
) | const |
Is a given combination allowed.
id1 | PDG code of the first particle. |
id2 | PDG code of the second particle. |
id3 | PDG code of the third particle. |
id4 | PDG code of the fourth particle. |
|
inline |
Calculate the kinematics for a 3-point vertex.
Definition at line 430 of file VertexBase.h.
References _kine.
|
inline |
Calculate the kinematics for a 4-point vertex.
Definition at line 444 of file VertexBase.h.
References _kine.
|
inline |
Calculate the kinematics for a n-point vertex.
Definition at line 463 of file VertexBase.h.
References _kine.
|
inline |
|
inlineprotected |
|
protectedvirtual |
Initialize this object after the setup phase before saving an EventGenerator to disk.
InitException | if object could not be initialized properly. |
Reimplemented from ThePEG::InterfacedBase.
|
inline |
Electromagnetic coupling.
Definition at line 260 of file VertexBase.h.
References _coupopt, _ee, ThePEG::Interfaced::generator(), and ThePEG::Constants::pi.
|
inline |
|
inline |
|
protectedvirtual |
Return a vector of all pointers to Interfaced objects used in this object.
Reimplemented from ThePEG::InterfacedBase.
|
inline |
Get the list of incoming particles.
Definition at line 155 of file VertexBase.h.
References _inpart.
|
inline |
Get one of the kinematic invariants.
Definition at line 475 of file VertexBase.h.
|
inline |
Is a particle allowed as an incoming particle?
p | The ParticleData pointer |
Definition at line 140 of file VertexBase.h.
References _inpart.
|
inline |
Is a particle allowed as an outgoing particle?
p | The ParticleData pointer |
Definition at line 148 of file VertexBase.h.
References _outpart.
|
inline |
Whether or not to calculate the kinematics invariants.
Definition at line 420 of file VertexBase.h.
References _calckinematics.
|
inline |
Set whether or not to calculate the kinematics invariants.
Definition at line 425 of file VertexBase.h.
References _calckinematics.
|
inline |
|
inlineprotected |
Members for the amplitude calculations.
Set the coupling.
coup | The coupling. |
Definition at line 384 of file VertexBase.h.
References _norm.
|
inlineprotected |
Calculate propagator multiplied by coupling.
iopt | The option for the Breit-Wigner shape |
q2 | The scale |
part | The ParticleData pointer for the off-shell particle. |
mass | The mass if not to be taken from the ParticleData object |
width | The width if not to be taken from the ParticleData object |
Definition at line 406 of file VertexBase.h.
References _norm, and propagator().
|
inline |
Get the total order of the vertex.
Definition at line 223 of file VertexBase.h.
References couplingOrders_.
|
inline |
Get the order in a specific coupling.
Definition at line 213 of file VertexBase.h.
References couplingOrders_.
|
inlineprotected |
Set the order in a specifc type of coupling.
Definition at line 498 of file VertexBase.h.
References couplingOrders_.
|
inline |
|
inlineprotected |
Set the order in \(g_EM\).
order | The order of the vertex in \(g_EM\) |
Definition at line 487 of file VertexBase.h.
References couplingOrders_.
|
inline |
|
inlineprotected |
Set the order in \(g_s\).
order | The order of the vertex in \(g_s\) |
Definition at line 493 of file VertexBase.h.
References couplingOrders_.
|
inline |
Get the list of outgoing particles.
Definition at line 160 of file VertexBase.h.
References _outpart.
void ThePEG::Helicity::VertexBase::persistentInput | ( | PersistentIStream & | is, |
int | version | ||
) |
Function used to read in object persistently.
is | the persistent input stream read from. |
version | the version number of the object when written. |
void ThePEG::Helicity::VertexBase::persistentOutput | ( | PersistentOStream & | os | ) | const |
Function used to write out object persistently.
os | the persistent output stream written to. |
|
protectedvirtual |
Calculate the propagator for a diagram.
iopt | The option for the Breit-Wigner shape |
q2 | The scale |
part | The ParticleData pointer for the off-shell particle. |
mass | The mass if not to be taken from the ParticleData object |
width | The width if not to be taken from the ParticleData object |
Referenced by normPropagator().
|
protectedvirtual |
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.
trans | a TranslationMap relating the original objects to their respective clones. |
RebindException | if no cloned object was found for a given pointer. |
Reimplemented from ThePEG::InterfacedBase.
vector< long > ThePEG::Helicity::VertexBase::search | ( | unsigned int | ilist, |
long | id | ||
) | const |
Function to search the list.
ilist | Which list to search |
id | The PDG code to look for. |
Function to search the list.
ilist | Which list to search |
id | The particle to look for. |
|
pure virtual |
Set coupling methods.
Calculate the couplings for a three point interaction. This method is virtual and must be implemented in classes inheriting from this.
q2 | The scale \(q^2\) for the coupling at the vertex. |
part1 | The ParticleData pointer for the first particle. |
part2 | The ParticleData pointer for the second particle. |
part3 | The ParticleData pointer for the third particle. |
Implemented in ThePEG::Helicity::FFSVertex, ThePEG::Helicity::GeneralVSSVertex, ThePEG::Helicity::GeneralVVSVertex, ThePEG::Helicity::RFSVertex, ThePEG::Helicity::SSSVertex, ThePEG::Helicity::VVSVertex, ThePEG::Helicity::FFTVertex, ThePEG::Helicity::SSTVertex, ThePEG::Helicity::VVTVertex, ThePEG::Helicity::FFVVertex, ThePEG::Helicity::GeneralFFVVertex, ThePEG::Helicity::RFVVertex, ThePEG::Helicity::VVVVertex, ThePEG::Helicity::SSSSVertex, ThePEG::Helicity::VVSSVertex, ThePEG::Helicity::VVVSVertex, ThePEG::Helicity::FFVTVertex, ThePEG::Helicity::VVVTVertex, and ThePEG::Helicity::VVVVVertex.
|
pure virtual |
Calculate the couplings for a four point interaction.
This method is virtual and must be implemented in classes inheriting from this.
q2 | The scale \(q^2\) for the coupling at the vertex. |
part1 | The ParticleData pointer for the first particle. |
part2 | The ParticleData pointer for the second particle. |
part3 | The ParticleData pointer for the third particle. |
part4 | The ParticleData pointer for the fourth particle. |
Implemented in ThePEG::Helicity::SSSSVertex, ThePEG::Helicity::VVSSVertex, ThePEG::Helicity::VVVSVertex, ThePEG::Helicity::FFVTVertex, ThePEG::Helicity::VVVTVertex, ThePEG::Helicity::VVVVVertex, ThePEG::Helicity::FFSVertex, ThePEG::Helicity::GeneralVSSVertex, ThePEG::Helicity::GeneralVVSVertex, ThePEG::Helicity::RFSVertex, ThePEG::Helicity::SSSVertex, ThePEG::Helicity::VVSVertex, ThePEG::Helicity::FFTVertex, ThePEG::Helicity::SSTVertex, ThePEG::Helicity::VVTVertex, ThePEG::Helicity::FFVVertex, ThePEG::Helicity::GeneralFFVVertex, ThePEG::Helicity::RFVVertex, and ThePEG::Helicity::VVVVertex.
|
inline |
Definition at line 283 of file VertexBase.h.
|
inline |
Access to the particle information.
Number of different particle combinations allowed.
Definition at line 133 of file VertexBase.h.
References _particles.
|
inline |
Strong coupling.
Definition at line 245 of file VertexBase.h.
References _coupopt, _gs, ThePEG::Interfaced::generator(), and ThePEG::Constants::pi.
|
inline |
Weak coupling.
Definition at line 272 of file VertexBase.h.
References _coupopt, _ee, _sw, ThePEG::Interfaced::generator(), and ThePEG::Constants::pi.
|
private |
Whether or not to calculate the kinematic invariants for the vertex.
Definition at line 551 of file VertexBase.h.
Referenced by kinematics().
|
private |
option for the coupling
Definition at line 576 of file VertexBase.h.
Referenced by electroMagneticCoupling(), strongCoupling(), and weakCoupling().
|
private |
Fixed value of the electromagentic coupling to use.
Definition at line 586 of file VertexBase.h.
Referenced by electroMagneticCoupling(), and weakCoupling().
|
private |
Fixed value of strong coupling to use.
Definition at line 581 of file VertexBase.h.
Referenced by strongCoupling().
|
private |
ParticleData pointers for the allowed incoming particles.
Definition at line 535 of file VertexBase.h.
Referenced by incoming(), and isIncoming().
|
private |
Kinematica quantities needed for loop vertices.
Definition at line 556 of file VertexBase.h.
Referenced by calculateKinematics(), and invariant().
|
private |
The overall coupling.
Definition at line 546 of file VertexBase.h.
Referenced by norm(), and normPropagator().
|
private |
Number of particles at the vertex.
Definition at line 530 of file VertexBase.h.
Referenced by getNpoint(), and invariant().
|
private |
ParticleData pointers for the allowed outgoing particles.
Definition at line 540 of file VertexBase.h.
Referenced by isOutgoing(), and outgoing().
|
private |
Storage of the particles.
Particles interacting at the vertex
Definition at line 525 of file VertexBase.h.
Referenced by size().
|
private |
Fixed value of \(\sin\theta_W\) to use.
Definition at line 591 of file VertexBase.h.
Referenced by weakCoupling().
|
private |
|
private |
Colour structure of the vertex.
Definition at line 566 of file VertexBase.h.
Referenced by colourStructure().
|
private |
The order of the vertex in specific couplings.
Definition at line 571 of file VertexBase.h.
Referenced by orderInAllCouplings(), orderInCoupling(), orderInGem(), and orderInGs().