thepeg is hosted by Hepforge, IPPP Durham
ThePEG 2.3.0
ThePEG::Helicity::GeneralVVSVertex Class Referenceabstract

The GeneralVVSVertex class implements a general Vector-Vector-Scalar vertex allowing for decay modes that only enter at the one-loop level. More...

#include <GeneralVVSVertex.h>

Inheritance diagram for ThePEG::Helicity::GeneralVVSVertex:

Public Member Functions

 GeneralVVSVertex ()
 The default constructor.
 
virtual Complex evaluate (Energy2 q2, const VectorWaveFunction &vec1, const VectorWaveFunction &vec2, const ScalarWaveFunction &sca3)
 Members to calculate the helicity amplitude expressions for vertices and off-shell particles.
 
virtual VectorWaveFunction evaluate (Energy2 q2, int iopt, tcPDPtr out, const VectorWaveFunction &vec2, const ScalarWaveFunction &sca3, complex< Energy > mass=-GeV, complex< Energy > width=-GeV)
 Evaluate the off-shell vector coming from the vertex.
 
virtual ScalarWaveFunction evaluate (Energy2 q2, int iopt, tcPDPtr out, const VectorWaveFunction &vec1, const VectorWaveFunction &vec2, complex< Energy > mass=-GeV, complex< Energy > width=-GeV)
 Evaluate the off-shell scalar coming from the vertex.
 
virtual void setCoupling (Energy2 q2, tcPDPtr part1, tcPDPtr part2, tcPDPtr part3)=0
 Set coupling methods.
 
virtual void setCoupling (Energy2, tcPDPtr, tcPDPtr, tcPDPtr, tcPDPtr)
 Dummy setCouplings for a four point interaction This method is virtual and must be implemented in classes inheriting from this.
 
- Public Member Functions inherited from ThePEG::Helicity::AbstractVVSVertex
 AbstractVVSVertex ()
 Default constructor.
 
virtual Complex evaluate (Energy2 q2, const VectorWaveFunction &vec1, const VectorWaveFunction &vec2, const ScalarWaveFunction &sca3)=0
 Members to calculate the helicity amplitude expressions for vertices and off-shell particles.
 
virtual VectorWaveFunction evaluate (Energy2 q2, int iopt, tcPDPtr out, const VectorWaveFunction &vec2, const ScalarWaveFunction &sca3, complex< Energy > mass=-GeV, complex< Energy > width=-GeV)=0
 Evaluate the off-shell vector coming from the vertex.
 
virtual ScalarWaveFunction evaluate (Energy2 q2, int iopt, tcPDPtr out, const VectorWaveFunction &vec1, const VectorWaveFunction &vec2, complex< Energy > mass=-GeV, complex< Energy > width=-GeV)=0
 Evaluate the off-shell scalar coming from the vertex.
 
- Public Member Functions inherited from ThePEG::Helicity::VertexBase
 VertexBase (VertexType::T name, bool kine=false)
 Constructor for \(n\)-point vertices.
 
double strongCoupling (Energy2 q2) const
 Strong coupling.
 
double electroMagneticCoupling (Energy2 q2) const
 Electromagnetic coupling.
 
double weakCoupling (Energy2 q2) const
 Weak coupling.
 
double sin2ThetaW () const
 
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 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< tPDPtrsearch (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.
 
- 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.
 

Static Public Member Functions

static void Init ()
 The standard Init function used to initialize the interfaces.
 
- Static Public Member Functions inherited from ThePEG::Helicity::AbstractVVSVertex
static void Init ()
 The standard Init function used to initialize the interfaces.
 
- Static Public Member Functions inherited from ThePEG::Helicity::VertexBase
static void Init ()
 Standard Init function used to initialize the interfaces.
 
- 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.
 

Private Attributes

Store tensor coefficients.
Complex _a00
 Coefficient of \(g^{\mu\nu}\).
 
Complex _a11
 Coefficient of \(p_1^\mu p_1^\nu\).
 
Complex _a12
 Coefficient of \(p_1^\mu p_2^\nu\).
 
Complex _a21
 Coefficient of \(p_2^\mu p_1^\nu\).
 
Complex _a22
 Coefficient of \(p_2^\mu p_2^\nu\).
 
Complex _aEp
 Coefficient of \(\epsilon^{\mu\nu\alpha\beta}p_1\alpha p_2\beta\).
 

Set and Get tensor coefficients.

Complex a00 () const
 Access coefficient of \(g^{\mu\nu}\).
 
Complex a11 () const
 Access coefficient of \(p_1^\mu p_1^\nu\).
 
Complex a12 () const
 Access coefficient of \(p_1^\mu p_2^\nu\).
 
Complex a21 () const
 Access coefficient of \(p_2^\mu p_1^\nu\).
 
Complex a22 () const
 Access coefficient of \(p_2^\mu p_2^\nu\).
 
Complex aEp () const
 Access coefficient of \(\epsilon^{\mu\nu\alpha\beta}p_1\alpha p_2\beta\).
 
void a00 (const Complex &val)
 Set tensor coefficient of \(g^{\mu\nu}\).
 
void a11 (const Complex &val)
 Set tensor coefficient of \(p_1^\mu p_1^\nu\).
 
void a12 (const Complex &val)
 Set tensor coefficient of \(p_1^\mu p_2^\nu\).
 
void a21 (const Complex &val)
 Set tensor coefficient of \(p_2^\mu p_1^\nu\).
 
void a22 (const Complex &val)
 Set tensor coefficient of \(p_2^\mu p_2^\nu\).
 
void aEp (const Complex &val)
 Set tensor coefficient of \(\epsilon^{\mu\nu\alpha\beta}p_1\alpha p_2\beta\).
 
GeneralVVSVertexoperator= (const GeneralVVSVertex &)=delete
 The assignment operator is private and must never be called.
 

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.
 
- Public Attributes inherited from ThePEG::Pointer::ReferenceCounted
const unsigned long uniqueId
 The unique ID.
 
- Protected Member Functions inherited from ThePEG::Helicity::VertexBase
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.
 
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.
 
- 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.
 
ReferenceCountedoperator= (const ReferenceCounted &)
 Assignment.
 
- Protected Member Functions inherited from ThePEG::Named
const Namedoperator= (const Named &other)
 Assignment.
 
const string & name (const string &newName)
 Set new name.
 
- 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.
 

Detailed Description

The GeneralVVSVertex class implements a general Vector-Vector-Scalar vertex allowing for decay modes that only enter at the one-loop level.

The loop integral is calculated by Passarino-Veltman reduction and the coefficients are stored here. They must be calculated in the inheriting class along with implementation of the setCoupling member.

The vertex takes the form

\[ a_{00}g^{\mu\nu}p_1\cdot p_2 + a_{11}p_1^\mu p_1^\nu + a_{12}p_1^\mu p_2^\nu + a_{21}p_2^\mu p_1^\nu + a_{22}p_2^\mu p_2^\nu +a_e\epsilon^{p_1 \mu \nu p_2}\]

Definition at line 34 of file GeneralVVSVertex.h.

Constructor & Destructor Documentation

◆ GeneralVVSVertex()

ThePEG::Helicity::GeneralVVSVertex::GeneralVVSVertex ( )
inline

The default constructor.

Definition at line 41 of file GeneralVVSVertex.h.

Member Function Documentation

◆ a00() [1/2]

Complex ThePEG::Helicity::GeneralVVSVertex::a00 ( ) const
inline

Access coefficient of \(g^{\mu\nu}\).

Definition at line 141 of file GeneralVVSVertex.h.

References _a00.

◆ a00() [2/2]

void ThePEG::Helicity::GeneralVVSVertex::a00 ( const Complex val)
inline

Set tensor coefficient of \(g^{\mu\nu}\).

Definition at line 171 of file GeneralVVSVertex.h.

References _a00.

◆ a11() [1/2]

Complex ThePEG::Helicity::GeneralVVSVertex::a11 ( ) const
inline

Access coefficient of \(p_1^\mu p_1^\nu\).

Definition at line 146 of file GeneralVVSVertex.h.

References _a11.

◆ a11() [2/2]

void ThePEG::Helicity::GeneralVVSVertex::a11 ( const Complex val)
inline

Set tensor coefficient of \(p_1^\mu p_1^\nu\).

Definition at line 176 of file GeneralVVSVertex.h.

References _a11.

◆ a12() [1/2]

Complex ThePEG::Helicity::GeneralVVSVertex::a12 ( ) const
inline

Access coefficient of \(p_1^\mu p_2^\nu\).

Definition at line 151 of file GeneralVVSVertex.h.

References _a12.

◆ a12() [2/2]

void ThePEG::Helicity::GeneralVVSVertex::a12 ( const Complex val)
inline

Set tensor coefficient of \(p_1^\mu p_2^\nu\).

Definition at line 181 of file GeneralVVSVertex.h.

References _a12.

◆ a21() [1/2]

Complex ThePEG::Helicity::GeneralVVSVertex::a21 ( ) const
inline

Access coefficient of \(p_2^\mu p_1^\nu\).

Definition at line 156 of file GeneralVVSVertex.h.

References _a21.

◆ a21() [2/2]

void ThePEG::Helicity::GeneralVVSVertex::a21 ( const Complex val)
inline

Set tensor coefficient of \(p_2^\mu p_1^\nu\).

Definition at line 186 of file GeneralVVSVertex.h.

References _a21.

◆ a22() [1/2]

Complex ThePEG::Helicity::GeneralVVSVertex::a22 ( ) const
inline

Access coefficient of \(p_2^\mu p_2^\nu\).

Definition at line 161 of file GeneralVVSVertex.h.

References _a22.

◆ a22() [2/2]

void ThePEG::Helicity::GeneralVVSVertex::a22 ( const Complex val)
inline

Set tensor coefficient of \(p_2^\mu p_2^\nu\).

Definition at line 191 of file GeneralVVSVertex.h.

References _a22.

◆ aEp() [1/2]

Complex ThePEG::Helicity::GeneralVVSVertex::aEp ( ) const
inline

Access coefficient of \(\epsilon^{\mu\nu\alpha\beta}p_1\alpha p_2\beta\).

Definition at line 166 of file GeneralVVSVertex.h.

References _aEp.

◆ aEp() [2/2]

void ThePEG::Helicity::GeneralVVSVertex::aEp ( const Complex val)
inline

Set tensor coefficient of \(\epsilon^{\mu\nu\alpha\beta}p_1\alpha p_2\beta\).

Definition at line 196 of file GeneralVVSVertex.h.

References _aEp.

◆ evaluate() [1/3]

virtual Complex ThePEG::Helicity::GeneralVVSVertex::evaluate ( Energy2  q2,
const VectorWaveFunction vec1,
const VectorWaveFunction vec2,
const ScalarWaveFunction sca3 
)
virtual

Members to calculate the helicity amplitude expressions for vertices and off-shell particles.

Evaluate the vertex.

Parameters
q2The scale \(q^2\) for the coupling at the vertex.
vec1The wavefunction for the first vector.
vec2The wavefunction for the second vector.
sca3The wavefunction for the scalar.

Implements ThePEG::Helicity::AbstractVVSVertex.

◆ evaluate() [2/3]

virtual ScalarWaveFunction ThePEG::Helicity::GeneralVVSVertex::evaluate ( Energy2  q2,
int  iopt,
tcPDPtr  out,
const VectorWaveFunction vec1,
const VectorWaveFunction vec2,
complex< Energy mass = -GeV,
complex< Energy width = -GeV 
)
virtual

Evaluate the off-shell scalar coming from the vertex.

Parameters
q2The scale \(q^2\) for the coupling at the vertex.
ioptOption of the shape of the Breit-Wigner for the off-shell scalar.
outThe ParticleData pointer for the off-shell scalar.
vec1The wavefunction for the first vector.
vec2The wavefunction for the second vector.
massThe mass of the off-shell particle if not taken from the ParticleData object
widthThe width of the off-shell particle if not taken from the ParticleData object

Implements ThePEG::Helicity::AbstractVVSVertex.

◆ evaluate() [3/3]

virtual VectorWaveFunction ThePEG::Helicity::GeneralVVSVertex::evaluate ( Energy2  q2,
int  iopt,
tcPDPtr  out,
const VectorWaveFunction vec2,
const ScalarWaveFunction sca3,
complex< Energy mass = -GeV,
complex< Energy width = -GeV 
)
virtual

Evaluate the off-shell vector coming from the vertex.

Parameters
q2The scale \(q^2\) for the coupling at the vertex.
ioptOption of the shape of the Breit-Wigner for the off-shell vector.
outThe ParticleData pointer for the off-shell vector.
vec2The wavefunction for the vector.
sca3The wavefunction for the scalar.
massThe mass of the off-shell particle if not taken from the ParticleData object
widthThe width of the off-shell particle if not taken from the ParticleData object

Implements ThePEG::Helicity::AbstractVVSVertex.

◆ Init()

static void ThePEG::Helicity::GeneralVVSVertex::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.

◆ operator=()

GeneralVVSVertex & ThePEG::Helicity::GeneralVVSVertex::operator= ( const GeneralVVSVertex )
privatedelete

The assignment operator is private and must never be called.

In fact, it should not even be implemented.

◆ setCoupling() [1/2]

virtual void ThePEG::Helicity::GeneralVVSVertex::setCoupling ( Energy2  q2,
tcPDPtr  part1,
tcPDPtr  part2,
tcPDPtr  part3 
)
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.

Parameters
q2The scale \(q^2\) for the coupling at the vertex.
part1The ParticleData pointer for the first particle.
part2The ParticleData pointer for the second particle.
part3The ParticleData pointer for the third particle.

Implements ThePEG::Helicity::VertexBase.

◆ setCoupling() [2/2]

virtual void ThePEG::Helicity::GeneralVVSVertex::setCoupling ( Energy2  ,
tcPDPtr  ,
tcPDPtr  ,
tcPDPtr  ,
tcPDPtr   
)
inlinevirtual

Dummy setCouplings for a four point interaction This method is virtual and must be implemented in classes inheriting from this.

Implements ThePEG::Helicity::VertexBase.

Definition at line 129 of file GeneralVVSVertex.h.

Member Data Documentation

◆ _a00

Complex ThePEG::Helicity::GeneralVVSVertex::_a00
private

Coefficient of \(g^{\mu\nu}\).

Definition at line 215 of file GeneralVVSVertex.h.

Referenced by a00().

◆ _a11

Complex ThePEG::Helicity::GeneralVVSVertex::_a11
private

Coefficient of \(p_1^\mu p_1^\nu\).

Definition at line 220 of file GeneralVVSVertex.h.

Referenced by a11().

◆ _a12

Complex ThePEG::Helicity::GeneralVVSVertex::_a12
private

Coefficient of \(p_1^\mu p_2^\nu\).

Definition at line 225 of file GeneralVVSVertex.h.

Referenced by a12().

◆ _a21

Complex ThePEG::Helicity::GeneralVVSVertex::_a21
private

Coefficient of \(p_2^\mu p_1^\nu\).

Definition at line 230 of file GeneralVVSVertex.h.

Referenced by a21().

◆ _a22

Complex ThePEG::Helicity::GeneralVVSVertex::_a22
private

Coefficient of \(p_2^\mu p_2^\nu\).

Definition at line 235 of file GeneralVVSVertex.h.

Referenced by a22().

◆ _aEp

Complex ThePEG::Helicity::GeneralVVSVertex::_aEp
private

Coefficient of \(\epsilon^{\mu\nu\alpha\beta}p_1\alpha p_2\beta\).

Definition at line 240 of file GeneralVVSVertex.h.

Referenced by aEp().


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