Particle Class Reference

Kinematic information for one particle. More...

#include <CepGen/Event/Particle.h>

Collaboration diagram for Particle:

Public Types
enum class	Status {   PrimordialIncoming = -9 , DebugResonance = -5 , Resonance = -4 , Fragmented = -3 ,   Propagator = -2 , Incoming = -1 , Undefined = 0 , FinalState = 1 ,   Undecayed = 2 , Unfragmented = 3 }
	Internal status code for a particle. More...
enum	Role {   UnknownRole = -1 , IncomingBeam1 = 1 , IncomingBeam2 = 2 , OutgoingBeam1 = 3 ,   OutgoingBeam2 = 5 , CentralSystem = 6 , Intermediate = 4 , Parton1 = 41 ,   Parton2 = 42 }

Public Member Functions
	Particle (Role role=Role::UnknownRole, pdgid_t id=0, Status st=Status::Undefined)
	Build using the role of the particle in the process and its PDG id.
bool	operator< (const Particle &) const
	Comparison operator (from unique identifier)
bool	operator== (const Particle &) const
	Equality operator.
int	id () const
	Unique identifier (in a Event object context) Set the particle unique identifier in an event.
Particle &	setId (int id)
float	charge () const
	Electric charge (given as a float number, for the quarks and bound states) Set whether we are coping with the particle or its antiparticle.
Particle &	setAntiparticle (bool anti)
Role	role () const
	Role in the considered process Set the particle role in the process.
Particle &	setRole (const Role &role)
Status	status () const
	Particle status Set the particle decay/stability status.
Particle &	setStatus (Status status)
Particle &	setStatus (int status)
	Set the particle decay/stability status.
Particle &	setPdgId (pdgid_t pdg, short ch=0)
	Set the PDG identifier (along with the particle's electric charge)
pdgid_t	pdgId () const
	Retrieve the objectified PDG identifier Set the PDG identifier (along with the particle's electric charge)
Particle &	setIntegerPdgId (long pdg_id)
long	integerPdgId () const
	Retrieve the integer value of the PDG identifier.
float	helicity () const
	Particle's helicity Set the helicity of the particle.
Particle &	setHelicity (float heli)
Momentum &	momentum ()
	Retrieve the momentum object associated with this particle Retrieve the momentum object associated with this particle.
const Momentum &	momentum () const
Particle &	setMomentum (const Momentum &, bool offshell=false)
	Associate a momentum object to this particle.
Particle &	setMomentum (double px, double py, double pz, double e=-1.)
	Set the 3- or 4-momentum associated to the particle.
Particle &	setMomentum (double p[4])
	Set the 4-momentum associated to the particle.
bool	valid ()
	Is this particle a valid particle which can be used for kinematic computations?
bool	primary () const
	Is this particle a primary particle?
Particle &	addMother (Particle &part)
	Set the mother particle.
ParticlesIds	mothers () const
	Identifier to the mother particles.
ParticlesIds &	mothers ()
	Identifier to the mother particles.
Particle &	addDaughter (Particle &part)
	Add a decay product.
ParticlesIds	daughters () const
	Identifiers list of all daughter particles.
ParticlesIds &	daughters ()
	Identifiers list of all daughter particles.

Protected Attributes
int	id_ {-1}
	Unique identifier in an event.
bool	antiparticle_ {false}
	Are we dealing with the particle or antiparticle?
Momentum	momentum_
	Momentum properties handler.
float	helicity_ {0.}
	Helicity.
Role	role_ {UnknownRole}
	Role in the process.
int	status_ {(int)Status::Undefined}
	Decay/stability status.
ParticlesIds	mothers_
	List of mother particles.
ParticlesIds	daughters_
	List of daughter particles.
pdgid_t	pdg_id_ {(pdgid_t)0}
	PDG id.

Friends
std::ostream &	operator<< (std::ostream &os, const Status &)
	Human-readable particle's status Role of the particle in the process.
std::ostream &	operator<< (std::ostream &os, const Role &)
	Human-readable particle's role in the event.
std::ostream &	operator<< (std::ostream &, const Particle &)
	Human-readable dump of particle information.

Detailed Description

Definition at line 33 of file Particle.h.

Member Enumeration Documentation

Role

enum Role

Enumerator
UnknownRole	Undefined role.
IncomingBeam1	\(z>0\) incoming beam particle
IncomingBeam2	\(z<0\) incoming beam particle
OutgoingBeam1	\(z<0\) outgoing beam state/particle
OutgoingBeam2	\(z>0\) outgoing beam state/particle
CentralSystem	Central particles system.
Intermediate	Intermediate two-parton system.
Parton1	\(z>0\) beam incoming parton
Parton2	\(z<0\) beam incoming parton

Definition at line 50 of file Particle.h.

Status

enum class Status

strong

Enumerator
PrimordialIncoming	Incoming beam particle.
DebugResonance	Intermediate resonance (for processes developers)
Resonance	Already decayed intermediate resonance.
Fragmented	Already fragmented outgoing beam.
Propagator	Generic propagator.
Incoming	Incoming parton.
Undefined	Undefined particle.
FinalState	Stable, final state particle.
Undecayed	Particle to be decayed externally.
Unfragmented	Particle to be hadronised externally.

Definition at line 36 of file Particle.h.

Constructor & Destructor Documentation

Particle()

Particle ( Role  role = Role::UnknownRole, pdgid_t  id = 0, Status  st = Status::Undefined  )

explicit

Parameters

[in]	role	Role of the particle in the process
[in]	id	PDG identifier
[in]	st	Current status

Definition at line 28 of file Particle.cpp.

Member Function Documentation

addDaughter()

Particle & addDaughter

(

Particle &

part

)

Definition at line 59 of file Particle.cpp.

addMother()

Particle & addMother

(

Particle &

part

)

Definition at line 47 of file Particle.cpp.

charge()

float charge

(

)

const

Definition at line 45 of file Particle.cpp.

daughters() [1/2]

ParticlesIds & daughters

(

)

Definition at line 148 of file Particle.h.

daughters() [2/2]

ParticlesIds daughters

(

)

const

Definition at line 147 of file Particle.h.

helicity()

float helicity

(

)

const

Definition at line 116 of file Particle.h.

id()

int id

(

)

const

Definition at line 76 of file Particle.h.

integerPdgId()

long integerPdgId

(

)

const

Definition at line 102 of file Particle.cpp.

momentum() [1/2]

Momentum & momentum

(

)

Definition at line 123 of file Particle.h.

momentum() [2/2]

const Momentum & momentum

(

)

const

Definition at line 125 of file Particle.h.

mothers() [1/2]

ParticlesIds & mothers

(

)

Definition at line 145 of file Particle.h.

mothers() [2/2]

ParticlesIds mothers

(

)

const

Definition at line 144 of file Particle.h.

operator<()

bool operator<

(

const Particle &

rhs

)

const

Definition at line 30 of file Particle.cpp.

operator==()

bool operator==

(

const Particle &

oth

)

const

Definition at line 32 of file Particle.cpp.

pdgId()

pdgid_t pdgId

(

)

const

Parameters

[in]

pdg_id

PDG identifier (incl. electric charge in e)

Definition at line 91 of file Particle.cpp.

primary()

bool primary

(

)

const

Definition at line 142 of file Particle.h.

role()

Role role

(

)

const

Definition at line 88 of file Particle.h.

setAntiparticle()

Particle & setAntiparticle

(

bool

anti

)

Definition at line 84 of file Particle.h.

setHelicity()

Particle & setHelicity

(

float

heli

)

Definition at line 118 of file Particle.h.

setId()

Particle & setId

(

int

id

)

Definition at line 78 of file Particle.h.

setIntegerPdgId()

Particle & setIntegerPdgId

(

long

pdg_id

)

Definition at line 95 of file Particle.cpp.

setMomentum() [1/3]

Particle & setMomentum	(	const Momentum &	mom,
		bool	offshell = false
	)

Parameters

[in]

offshell

allow the 4-momentum mass to compensate for E-p balance?

Definition at line 77 of file Particle.cpp.

setMomentum() [2/3]

Particle & setMomentum

(

double

p[4]

)

Parameters

[in]

p

4-momentum

Definition at line 137 of file Particle.h.

setMomentum() [3/3]

Particle & setMomentum	(	double	px,
		double	py,
		double	pz,
		double	e = -1.
	)

Parameters

[in]	px	Momentum along the \(x\)-axis, in GeV/c
[in]	py	Momentum along the \(y\)-axis, in GeV/c
[in]	pz	Momentum along the \(z\)-axis, in GeV/c
[in]	e	Energy, in GeV

Definition at line 84 of file Particle.cpp.

setPdgId()

Particle & setPdgId	(	pdgid_t	pdg,
		short	ch = 0
	)

Parameters

[in]	pdg	PDG identifier
[in]	ch	Electric charge (0, 1, or -1)

Definition at line 93 of file Particle.cpp.

setRole()

Particle & setRole

(

const Role &

role

)

Definition at line 90 of file Particle.h.

setStatus() [1/2]

Particle & setStatus

(

int

status

)

Definition at line 101 of file Particle.h.

setStatus() [2/2]

Particle & setStatus

(

Status

status

)

Definition at line 96 of file Particle.h.

status()

Status status

(

)

const

Definition at line 94 of file Particle.h.

valid()

bool valid

(

)

Definition at line 37 of file Particle.cpp.

Friends And Related Symbol Documentation

operator<< [1/3]

std::ostream & operator<< ( std::ostream &  os, const Particle &  part  )

friend

Definition at line 104 of file Particle.cpp.

operator<< [2/3]

std::ostream & operator<< ( std::ostream &  os, const Role &  rl  )

friend

Definition at line 156 of file Particle.cpp.

operator<< [3/3]

std::ostream & operator<< ( std::ostream &  os, const Status &  st  )

friend

Definition at line 130 of file Particle.cpp.

Member Data Documentation

antiparticle_

bool antiparticle_ {false}

protected

Definition at line 156 of file Particle.h.

daughters_

ParticlesIds daughters_

protected

Definition at line 162 of file Particle.h.

helicity_

float helicity_ {0.}

protected

Definition at line 158 of file Particle.h.

id_

int id_ {-1}

protected

Definition at line 155 of file Particle.h.

momentum_

Momentum momentum_

protected

Definition at line 157 of file Particle.h.

mothers_

ParticlesIds mothers_

protected

Definition at line 161 of file Particle.h.

pdg_id_

pdgid_t pdg_id_ {(pdgid_t)0}

protected

Definition at line 163 of file Particle.h.

role_

Role role_ {UnknownRole}

protected

Definition at line 159 of file Particle.h.

status_

int status_ {(int)Status::Undefined}

protected

Definition at line 160 of file Particle.h.