Skip to content

Particle

Particle 

Particle(pdg_id: int)

Particle object representing a physics particle.

This class stores particle properties such as PDG ID, name, mass, and standard track length for use in light yield calculations.

Parameters:

Name Type Description Default
pdg_id int

The PDG (Particle Data Group) identification number of the particle. Supported particles include electrons (11), positrons (-11), muons (13, -13), photons (22), pions (211, -211), kaons (130), protons (2212, -2212), and neutrons (2112).

 required

Attributes:

Name Type Description
_pdg_id int

The PDG identification number
_name str

Particle name following PDG Monte Carlo naming convention
_energies ndarray

Energy grid for calculations
_mass (float, optional)

Particle rest mass in GeV (for muons)
_std_track (float, optional)

Standard track length in cm (for muons)

Examples:

>>> from fennel.particle import Particle
>>> muon = Particle(13)
>>> print(muon._name)
'mu-'
Notes

Currently, only muons have their mass and standard track length implemented.

Initialize a Particle object.

Parameters:

Name Type Description Default
pdg_id int

The PDG number of the particle

 required

Raises:

Type Description
KeyError

If the PDG ID is not recognized in the configuration
Source code in fennel/particle.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
def __init__(self, pdg_id: int) -> None:
    """
    Initialize a Particle object.

    Parameters
    ----------
    pdg_id : int
        The PDG number of the particle

    Raises
    ------
    KeyError
        If the PDG ID is not recognized in the configuration
    """
    if not config["general"]["enable logging"]:
        _log.disabled = True
    _log.info("Constructing a particle")
    self._pdg_id = pdg_id
    # Naming conventions PDG Monte Carlo scheme
    self._name = config["pdg id"][pdg_id]
    _log.debug("The final name is " + self._name)
    self._energies = config["advanced"]["energy grid"]
    # TODO: Add masses for all particles
    # Masses of the muons
    if self._name[:2] == "mu":
        self._mass = config[self._name]["mass"]
        self._std_track = config[self._name]["standard track length"]