Version 0.21.0

• Data files:
  • Added the 2022 PDG data table file, now default.
  • Version 11 of package CSV data files:
    • Since PDG 2022 information now the default.
• Classes for MC particle identification codes and converters:
  • New Corsika7ID class.
  • New Corsika72PDGIDBiMap bi-directional map between PDG and Corsika7 IDs.
• Particle class, PDGID like classes and related standalone functions:
  • New method Particle.from_nucleus().
  • Extra documentation.
• Miscellaneous:
  • Added a CITATION.cff file.
  • Moved over to using hatchling.
  • Added support for Python 3.11 and dropped support for Python 3.6.
  • Adapted to Pandas 1.5 series (removal of deprecation warnings).
• Documentation:
  • Minor README updates.
• Tests:
  • Updates to pre-commit hooks and CI YAML files.
  • Various improvements to the CI.

Version 0.20.1

• Particle class:
  • More tests of PDGID functions for special particles.
• Experiment-specific modules:
  • particle.lhcb simplified.
• Miscellaneous:
  • Minor cleanup and updates.
• Tests:
  • Now included in the SDist (MANIFEST.in updated).
  • Pre-commit hooks updated.

Version 0.20.0

First Python 3 (3.6+) only version.

• Particle class:
  • Deprecated method find method removed. Use findall or finditer instead.
  • HTML Greek letters in particle names use hex code rather than entity name.
• PDGID class method and related standalone functions:
  • Deprecated function is_composite_quark_or_lepton removed. Use is_excited_quark_or_lepton instead.
• Documentation:
  • README updated with info on the new experiment-specific module particle.lhcb.
• Miscellaneous:
  • Support for Python 2 and Python 3.5 dropped.
  • Full static typing implemented.
• Tests:
  • Pre-commit hooks updated.

Version 0.16.3

• Particle class:
  • New class method Particle.from_name.
• New experiment-specific module:
  • Module particle.lhcb with functions and mappings to deal with particle names in use in LHCb software.
  • Script admin/dump_pdgid_to_lhcb.py to generate the PDGID <-> LHCb name mapping (CSV file).
• Tests:
  • Updated pre-commit hooks.

Version 0.16.2

• Particle class:
  • Faster Particle.from_pdgid.
  • Better coverage of documentation for Particle methods, especially for newest method finditer.
  • Do not expose converters on high-level imports. Usage is hence from particle.converters import ....
• Tests:
  • Resurrected tests on "all" platforms - Linux, macOS and Windows.
  • Performance benchmark tests added for loading of particle property CSV files.
  • Updated pre-commit hooks.
• Miscellaneous:
  • Enforced Black formatting in notebooks.

Version 0.16.1

• Fixed a regression with the import time being unreasonably slow.
• Restore Python 3.5 support (no benefit to drop until 2.7 is dropped)

Version 0.16.0

• Particle class:
  • Added finditer, which returns an iterator instead of a complete list like findall.
  • Method find deprecated. It will be removed from version 0.17.0 onwards.
    Please use the more general findall method, or the new finditer method.
• PDGID class:
  • New functions is_sm_lepton, is_sm_quark and is_excited_quark_or_lepton
    for qualification of PDG IDs.
  • is_composite_quark_or_lepton deprecated in favour of better named is_excited_quark_or_lepton.
  • is_lepton fixed to match the behaviour of the related is_quark,
    i.e. now excited leptons are not considered leptons (only SM and 4th generation leptons).
  • Improvements to documentation.
  • Test suite enhanced accordingly.
• Data files:
  • Added the 2021 PDG data table .mcd file, now default.
  • Version 10 of package CSV data files:
    • Since PDG 2021 information now the default.
  • Lifetimes of neutrinos set to infinity.
  • Check added for duplicate entries in .mcd PDG data files.
• Tests:
  • Tests of coverage added back, using Codecov on GHAs.
  • CI enhanced, e.g. adding codespell, isort and flake8 checks tp pre-commit hooks.
• Miscellaneous:
  • Support for Python 3.10 added.
  • Several FutureWarning warnings fixed.
  • Code modernisation.

Version 0.15.1

• Particle class:
  • Bug fix in Particle.to_dict.
• Tests:
  • CI improvements.
  • Azure pipelines removed since superseded by GitHub Actions.
• Miscellaneous:
  • Code improvements thanks to Sourcery.
  • Clean-up of unnecessary files/code.

Version 0.15.0

• Particle class:
  • Literals now defined for all particles in the loaded "database" CSV file, excluding nuclei.
  • Defined and/or fixed the programmatic names for diquarks and SUSY particles.
• Data CSV files:
  • Version 9 of package data files, with all antiparticle bars done with \overline instead of \bar.
• Miscellaneous:
  • Added latex_name_unicode() function to convert in particle names in LaTeX all greek letters by their unicode.
  • Added a .zenodo.json file to provide enhanced metadata for Zenodo.
  • CI updates for newer versions of Black and pre-commit.

Version 0.14.1

• Code refactored in the CI by Sourcery.ai.
• Updates to versions of pre-commit hooks.