Make curated PDG particle data table 2025 the default (#702)

eduardo-rodrigues · web-flow · commit 7d46bc7803fd · 2025-09-30T15:17:10.000+02:00
* Make particle2025.csv default

* Update src/particle/particle/convert.py

* Update tests accordingly

* Update other tests to run over latest CSV

* Update README files

* Update doctests accordingly

* Update CSV files to version 14 as particle2025.csv
diff --git a/README.md b/README.md
@@ -209,7 +209,7 @@ with easily recognisable names. For example:
 >>>
 >>> from particle.literals import Lambda_b_0
 >>> Lambda_b_0
-<Particle: name="Lambda(b)0", pdgid=5122, mass=5619.60 ± 0.17 MeV>
+<Particle: name="Lambda(b)0", pdgid=5122, mass=5619.57 ± 0.16 MeV>
 >>> Lambda_b_0.J
 0.5
 ```
@@ -255,7 +255,7 @@ If you want a non-default data file distributed with the package just proceed as
 
 ```python
 >>> from particle import data
->>> Particle.load_table(data.basepath / "particle2024.csv"))
+>>> Particle.load_table(data.basepath / "particle2025.csv"))
 >>> Particle.load_table(data.basepath / "nuclei2022.csv"), append=True)  # I still want nuclei info
 >>> Particle.table_names()  # list the loaded tables
 ```
diff --git a/src/particle/data/README.rst b/src/particle/data/README.rst
@@ -1,7 +1,7 @@
 Particle Data folder contents
 -----------------------------
 
-You can ``import particle.data``, then use ``particle.data.basepath / "particle2024.csv"``
+You can ``import particle.data``, then use ``particle.data.basepath / "particle2025.csv"``
 to access data reliably regardless of how you have installed or are running the package (even from a zip file!).
 
 
@@ -20,7 +20,7 @@ An extension file for the extended PDG data file, prepared by this package's mai
 It contains entries necessary to provide extended information for the particles in the standard .mcd file.
 
 
-``mass_width_2024.mcd``
+``mass_width_2025.mcd``
 =======================
 
 The latest version of the PDG particle data file, downloaded from the PDG website
@@ -29,7 +29,7 @@ with much less information, but with more particles and more up to date.
 A few older years are included, too.
 
 
-``particle2024.csv``
+``particle2025.csv``
 ====================
 
 The combined data file, in a format that is easy for the ``Particle`` class to read and easy for physicists to extend or edit.
@@ -43,15 +43,15 @@ If you'd like to append to this file, write a similar file with the same header,
 to read in the original table and then the new file you've written.
 
 This file was created from ``pdgid_to_latexname.csv``, ``mass_width_2008.fwf``,
-``mass_width_2008_ext.fwf`` and ``mass_width_2024.mcd``.
+``mass_width_2008_ext.fwf`` and ``mass_width_2025.mcd``.
 The 2008 version of the file was created with only the first two.
 
 
 ``nuclei2022.csv``
 ==================
 
 Information on nuclei extracted and adapted from package ``periodictable``,
-available in the same format as that of ``particle2024.csv``.
+available in the same format as that of ``particle2025.csv``.
 
 
 ``conversions.csv``
diff --git a/src/particle/data/conversions.csv b/src/particle/data/conversions.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - conversions.csv - version 13 - 2023-07-03
+# (c) Scikit-HEP project - Particle package data file - conversions.csv - version 15 - 2025-09-30
       PDGID,   PYTHIAID,   GEANT3ID,            PDGNAME,            EVTGENNAME,                          LATEXNAME
           1,          1,        303,                  d,                     d,                                  d
          -1,         -1,        304,                 d~,                anti-d,                       \overline{d}
diff --git a/src/particle/data/nuclei2022.csv b/src/particle/data/nuclei2022.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - nuclei2022.csv - version 14 - 2024-08-08
+# (c) Scikit-HEP project - Particle package data file - nuclei2022.csv - version 15 - 2025-09-30
 ID,Mass,MassUpper,MassLower,Width,WidthUpper,WidthLower,I,G,P,C,Anti,Charge,Rank,Status,Name,Quarks,Latex
 1000000010,939.5654205,5e-07,5e-07,7.493e-25,4e-28,4e-28,1/2,5,1,5,1,0,4,0,n,udd,n
 -1000000010,939.5654205,5e-07,5e-07,7.493e-25,4e-28,4e-28,1/2,5,-1,5,1,0,4,0,n,UDD,\overline{n}
diff --git a/src/particle/data/particle2025.csv b/src/particle/data/particle2025.csv
diff --git a/src/particle/data/pdgid_to_corsika7id.csv b/src/particle/data/pdgid_to_corsika7id.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - pdgid_to_corsika7id.csv - version 14 - 2024-08-08
+# (c) Scikit-HEP project - Particle package data file - pdgid_to_corsika7id.csv - version 15 - 2025-09-30
 # Auto generated by 'admin/dump_pdgid_to_corsika7.py'
 PDGID,CORSIKA7ID
 22,1
diff --git a/src/particle/data/pdgid_to_evtgenname.csv b/src/particle/data/pdgid_to_evtgenname.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - pdgid_to_evtgenname.csv - version 14 - 2024-08-08
+# (c) Scikit-HEP project - Particle package data file - pdgid_to_evtgenname.csv - version 15 - 2025-09-30
 PDGID,STR
 1,d
 -1,anti-d
diff --git a/src/particle/data/pdgid_to_geant3id.csv b/src/particle/data/pdgid_to_geant3id.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - pdgid_to_geant3id.csv - version 14 - 2024-08-08
+# (c) Scikit-HEP project - Particle package data file - pdgid_to_geant3id.csv - version 15 - 2025-09-30
 PDGID,GEANT3ID
 1,303
 -1,304
diff --git a/src/particle/data/pdgid_to_latexname.csv b/src/particle/data/pdgid_to_latexname.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - pdgid_to_latexname.csv - version 14 - 2024-08-08
+# (c) Scikit-HEP project - Particle package data file - pdgid_to_latexname.csv - version 15 - 2025-09-30
 PDGID,LATEXNAME
 1,d
 2,u
diff --git a/src/particle/data/pdgid_to_pythiaid.csv b/src/particle/data/pdgid_to_pythiaid.csv
@@ -1,4 +1,4 @@
-# (c) Scikit-HEP project - Particle package data file - pdgid_to_pythiaid.csv - version 14 - 2024-08-08
+# (c) Scikit-HEP project - Particle package data file - pdgid_to_pythiaid.csv - version 15 - 2025-09-30
 PDGID,PYTHIAID
 1,1
 -1,-1
diff --git a/src/particle/particle/convert.py b/src/particle/particle/convert.py
@@ -8,7 +8,7 @@
 
 The default CSV files can be updated directly using the command:
 
-    >>> python -m particle.particle.convert regenerate 2024 <version_number>    # doctest: +SKIP
+    >>> python -m particle.particle.convert regenerate 2025 <version_number>    # doctest: +SKIP
 
 A custom fwf file and LaTeX file can be converted into the CSV format using:
 
@@ -33,7 +33,7 @@
 
 You can also read in a modern "standard" file (this will produce fewer columns):
 
-    >>> ext_table = get_from_pdg_mcd('particle/data/mass_width_2024.mcd')
+    >>> ext_table = get_from_pdg_mcd('particle/data/mass_width_2025.mcd')
 
 A utility is even provided to use the modern table to update the full table:
 
@@ -288,11 +288,11 @@ def sort_particles(table: pd.DataFrame) -> None:
 
 def get_from_pdg_mcd(filename: StringOrIO) -> pd.DataFrame:
     """
-    Reads in a current-style PDG .mcd file (mass_width_2024.mcd file tested).
+    Reads in a current-style PDG .mcd file (mass_width_2025.mcd file tested).
 
     Example
     -------
-    >>> mcd_table = get_from_pdg_mcd('particle/data/mass_width_2024.mcd')
+    >>> mcd_table = get_from_pdg_mcd('particle/data/mass_width_2025.mcd')
     """
 
     # The format here includes the space before a column
@@ -378,7 +378,7 @@ def update_from_mcd(
 
     Example
     -------
-    >>> new_table = update_from_mcd('mass_width_2008.fwf', 'mass_width_2024.mcd')    # doctest: +SKIP
+    >>> new_table = update_from_mcd('mass_width_2008.fwf', 'mass_width_2025.mcd')    # doctest: +SKIP
     """
 
     full_table = full_table.copy()
@@ -392,7 +392,7 @@ def update_from_mcd(
 
 def produce_files(
     particle2008: str | Path,  # noqa: ARG001
-    particle2024: str | Path,
+    particle2025: str | Path,
     version: str,
     year: str,
 ) -> None:
@@ -455,8 +455,8 @@ def produce_files(
 
     new_table = update_from_mcd(full_table, ext_table)
 
-    with open(particle2024, "w", newline="\n", encoding="utf-8") as f:
-        f.write(version_header(str(particle2024), version))
+    with open(particle2025, "w", newline="\n", encoding="utf-8") as f:
+        f.write(version_header(str(particle2025), version))
         new_table.to_csv(f, float_format="%.12g")
 
 
diff --git a/src/particle/particle/literals.py b/src/particle/particle/literals.py
@@ -19,7 +19,7 @@
     'pi+'
     >>> from particle.literals import Lambda_b_0
     >>> Lambda_b_0
-    <Particle: name="Lambda(b)0", pdgid=5122, mass=5619.60 ± 0.17 MeV>
+    <Particle: name="Lambda(b)0", pdgid=5122, mass=5619.57 ± 0.16 MeV>
     >>> Lambda_b_0.J
     0.5
 
diff --git a/src/particle/particle/particle.py b/src/particle/particle/particle.py
@@ -566,8 +566,8 @@ def load_table(
         assert cls._table_names is not None
 
         if filename is None:
-            with data.basepath.joinpath("particle2024.csv").open() as fa:
-                cls.load_table(fa, append=append, _name="particle2024.csv")
+            with data.basepath.joinpath("particle2025.csv").open() as fa:
+                cls.load_table(fa, append=append, _name="particle2025.csv")
             with data.basepath.joinpath("nuclei2022.csv").open() as fb:
                 cls.load_table(fb, append=True, _name="nuclei2022.csv")
             return
diff --git a/tests/particle/test_generation.py b/tests/particle/test_generation.py
@@ -33,19 +33,19 @@
     three_charge,
 )
 
-FILES = ["particle2023.csv", "particle2024.csv"]
+FILES = ["particle2024.csv", "particle2025.csv"]
 
 
 def test_generate(tmp_path):
     "This verifies that the input and output files match."
 
-    particle2023 = tmp_path / "particle2023.csv"
     particle2024 = tmp_path / "particle2024.csv"
+    particle2025 = tmp_path / "particle2025.csv"
 
-    produce_files(particle2023, particle2024, "DUMMY", "2024")
+    produce_files(particle2024, particle2025, "DUMMY", "2025")
 
-    particle2024_data = data.basepath / "particle2024.csv"
-    with particle2024.open() as src, particle2024_data.open() as res:
+    particle2025_data = data.basepath / "particle2025.csv"
+    with particle2025.open() as src, particle2025_data.open() as res:
         src_filtered = [line for line in src.readlines() if not line.startswith("#")]
         res_filtered = [line for line in res.readlines() if not line.startswith("#")]
         assert src_filtered == res_filtered
diff --git a/tests/particle/test_particle.py b/tests/particle/test_particle.py
@@ -351,7 +351,7 @@ def test_C_consistency():
     [4222, "Width = 1.89 + 0.09 - 0.18 MeV"],  # Sigma_c(2455)++
     [23, "Width = 2495.5 ± 2.3 MeV"],  # H0
     # Test print-out of symmetric lifetime errors
-    [5332, "Lifetime = 1.65e-03 + 1.8e-04 - 1.8e-04 ns"],  # Omega_b-
+    [5332, "Lifetime = 1.65e-03 ± 1.8e-04 ns"],  # Omega_b-
     [211, "Lifetime = 26.033 ± 0.005 ns"],  # pion
     # Test print-out of asymmetric lifetime errors
     [4332, "Lifetime = 2.73e-04 ± 1.3e-05 ns"],  # Omega_c^0
@@ -369,24 +369,26 @@ def test_describe(pid, description):
 
 
 def test_default_table_loading():
-    assert Particle.table_names() == ("particle2024.csv", "nuclei2022.csv")
+    assert Particle.table_names() == ("particle2025.csv", "nuclei2022.csv")
 
 
 def test_default_table_loading_bis():
     Particle.all()
     p = Particle.from_pdgid(211)
     assert p.table_loaded() is True
-    assert p.table_names() == ("particle2024.csv", "nuclei2022.csv")
+    assert p.table_names() == ("particle2025.csv", "nuclei2022.csv")
 
 
 def test_explicit_table_loading():
-    Particle.load_table(data.basepath / "particle2024.csv")
+    Particle.load_table(data.basepath / "particle2025.csv")
     assert Particle.table_loaded()
     assert len(Particle.table_names()) == 1
     assert Particle.all() is not None
 
 
 def test_all_particles_are_loaded():
+    Particle.load_table(data.basepath / "particle2025.csv")
+    assert len(Particle.all()) == 626
     Particle.load_table(data.basepath / "particle2024.csv")
     assert len(Particle.all()) == 625
     Particle.load_table(data.basepath / "particle2023.csv")
diff --git a/tests/particle/test_performance.py b/tests/particle/test_performance.py
@@ -4,19 +4,19 @@
 
 
 def test_load_particle_table(benchmark):
-    benchmark(Particle.load_table, data.basepath / "particle2024.csv")
+    benchmark(Particle.load_table, data.basepath / "particle2025.csv")
 
 
 def test_load_nuclei_append(benchmark):
     def load_two():
-        Particle.load_table(data.basepath / "particle2024.csv")
+        Particle.load_table(data.basepath / "particle2025.csv")
         Particle.load_table(data.basepath / "nuclei2022.csv", append=True)
 
     benchmark(load_two)
 
 
 def test_from_pdgid(benchmark):
-    Particle.load_table(data.basepath / "particle2024.csv")
+    Particle.load_table(data.basepath / "particle2025.csv")
     table = [int(s.pdgid) for s in Particle.all()]
 
     def get_all(listing):

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# (c) Scikit-HEP project - Particle package data file - conversions.csv - version 13 - 2023-07-03`
	`1`	`+# (c) Scikit-HEP project - Particle package data file - conversions.csv - version 15 - 2025-09-30`
`2`	`2`	`PDGID, PYTHIAID, GEANT3ID, PDGNAME, EVTGENNAME, LATEXNAME`
`3`	`3`	`1, 1, 303, d, d, d`
`4`	`4`	`-1, -1, 304, d~, anti-d, \overline{d}`