## main294-python

Back to index.

    # main294.py is a part of the PYTHIA event generator.
    # Copyright (C) 2026 Torbjorn Sjostrand.
    # PYTHIA is licenced under the GNU GPL v2 or later, see COPYING for details.
    # Please respect the MCnet Guidelines, see GUIDELINES for details.

    # Authors:
    #            Philip Ilten

    # Keywords:
    #            Particle data
    #            Python

    # This provides a simple Python class which reads and parses the Pythia 8
    # particle database, without requiring the Pythia 8 Python bindings.

    #==========================================================================

    class ParticleData:
        """
        The 'ParticleData' class stores the necessary information to
        define a particle.
        """

        #----------------------------------------------------------------------
        def __init__(self, id = 0, name = "", m0 = 0, tau0 = float("inf"),
                     spinType = 0, chargeType = 0, colType = 0,
                     mWidth = 0, mMin = 0, mMax = float("inf"), varWidth = False,
                     antiName = ""):
            """
            Initialize the class with the following: 'id' is the particle ID
            number, 'name' the name, 'm0' the mass in GeV, 'tau0' the
            proper lifetime in mm/c, 'spinType' twice the particle spin,
            'chargeType' is three times the electromagnetic chargeType,
            'colType' is the colType type, 'mWidth' is the particle width
            in GeV, 'mMin' is the minimum mass in GeV, 'mMax' is the
            maximum mass in GeV, 'varWidth' is a flag if variable width
            should be used, and 'antiName' is a dummy argument not used.
            """
            self.id = int(id)
            self.name = str(name)
            self.m0 = float(m0)
            self.tau0 = float(tau0)
            self.spinType = int(spinType)
            self.chargeType = int(chargeType)
            self.colType = int(colType)
            self.mWidth = float(mWidth)
            self.mMin = float(mMin)
            self.mMax = float(mMax)
            self.varWidth = varWidth == "on"
            self.anti = antiName if antiName else None
            self.n = tuple([int(self.id/pow(10, i)) % 10 for i in range(10)])
            if self.mMax == 0: self.mMax = float("inf")

        #----------------------------------------------------------------------
        def isQuark(self): return 0 < abs(self.id) < 10
        def isDiquark(self): return 1000 < abs(self.id) < 10000
        def isBaryon(self):
            id = abs(self.id)
            return not (
                id <= 1000 or 1000000 <= id <= 9000000 or id >= 9900000 or
                self.n[0] == 0 or self.n[1] == 0 or self.n[2] == 0 or
                self.n[3] == 0)
        def isMeson(self):
            id = abs(self.id)
            if id == 130 or id == 310: return True
            return not (
                id <= 100 or 1000000 <= id <= 9000000 or id >= 9900000 or
                self.n[0] == 0 or self.n[1] == 0 or self.n[2] == 0 or
                self.n[3] != 0)
        def isNucleus(self): return abs(self.id) > 1000000000

        #----------------------------------------------------------------------
        def __str__(self):
            """
            Return a string to print of this particle data.
            """
            return ("%10s: %s\n"*9 + "%10s: %s") % (
                "id", self.id, "name", self.name, "m0", self.m0,
                "tau0", self.tau0, "spinType", self.spinType, "chargeType",
                self.chargeType, "colType", self.colType, "mWidth", self.mWidth,
                "mMin", self.mMin, "mMax", self.mMax)

    #==========================================================================

    class ParticleDatabase(dict):
        """
        The 'ParticleDatabase' initializes and stores the 'ParticleData' for
        all particles in the 'ParticleData.xml' file from Pythia 8.
        """

        #----------------------------------------------------------------------
        def __init__(self, xmlfile = None):
            """
            Read in the particle data from the XML file 'xmlfile'.
            """
            # Find the XML file, if not provided.
            if xmlfile == None:
                try:
                    cfg = open("Makefile.inc")
                    for line in cfg:
                        if line.startswith("PREFIX_SHARE="):
                            xmlfile = line.split("=", 1)[-1].strip(); break
                    cfg.close()
                except:
                    import os
                    xmlfile = os.path.dirname(os.path.abspath(__file__))
                    xmlfile += "/../share/Pythia8"
                xmlfile += "/xmldoc/ParticleData.xml"

            # Instantiate the base class and open the XML file.
            dict.__init__(self)
            xml = open(xmlfile)
            # Loop over the file.
            pstr = ""
            for line in xml:
                line = line.strip()
                if line.startswith("<particle"): pstr = line
                elif pstr:
                    pstr += " " + line
                    if line.endswith(">"):
                        self.add(pstr)
                        pstr = ""
            xml.close()

        #----------------------------------------------------------------------
        def add(self, pstr):
            """
            Parses the XML for a particle and adds it to the database.
            """
            import shlex
            # Create the dictionary.
            pdct = {pair.split("=", 1)[0]: pair.split("=", 1)[1] for pair
                    in shlex.split(pstr[9:-1])}
            # Add the particle.
            pdat = ParticleData(**pdct)
            self[pdat.id] = pdat
            self[pdat.name] = pdat
            # Add the anti-particle if it exists, flip ID and charge.
            if pdat.anti:
                pdct["name"] = pdat.anti
                pdct["id"] = -pdat.id
                pdct["chargeType"] = -pdat.chargeType
                adat = ParticleData(**pdct)
                self[adat.id], self[adat.name] = adat, adat
                pdat.anti, adat.anti = adat, pdat

    #==========================================================================

    from sys import argv
    if __name__== "__main__":

        # Parse particle request.
        if len(argv) < 2:
            print("Usage:\n  python main294.py <particle id/name>")
            exit(1)
        try:
            key = int(argv[1])
        except ValueError:
            key = argv[1]

        # Create a ParticleDatabase object and print the electron info.
        pdb = ParticleDatabase()
        try:
            print(pdb[key])
        except KeyError:
            print("Particle id or name not found: " + argv[1])