juliensimon/pdg-particle-properties

--- license: cc-by-4.0 pretty_name: "PDG Particle Properties" language: - en description: "Every known particle from the Particle Data Group (PDG) — THE reference used by every particle physicist." task_categories: - tabular-classification - tabular-regression tags: - physics - particle - pdg - standard-model - high-energy-physics - open-data size_categories: - n<1K --- # PDG Particle Properties   Properties of every known particle from the Particle Data Group (PDG). Currently **6,506** particles. ## Dataset description The Particle Data Group (PDG) is THE definitive reference for particle physics properties, used by every particle physicist worldwide. This dataset provides a machine-readable version of the PDG particle listings, including masses, widths, lifetimes, quantum numbers, and decay properties for all known elementary particles, hadrons, and nuclei. Data is sourced via the `particle` Python package which provides clean, programmatic access to the full PDG dataset. ## Schema | Column | Type | Description | |--------|------|-------------| | `pdg_id` | int64 | PDG Monte Carlo particle ID | | `name` | string | Particle name (e.g. "pi+", "K*(892)0") | | `latex_name` | string | LaTeX-formatted name | | `mass_mev` | float64 | Mass (MeV/c^2) | | `mass_uncertainty_mev` | float64 | Mass upper uncertainty (MeV/c^2) | | `width_mev` | float64 | Decay width (MeV) | | `width_uncertainty_mev` | float64 | Width upper uncertainty (MeV) | | `charge` | float64 | Electric charge (units of e) | | `spin` | float64 | Spin J | | `parity` | Int64 | Parity P (+1 or -1) | | `isospin` | string | Isospin I | | `g_parity` | Int64 | G-parity (+1 or -1) | | `c_parity` | Int64 | C-parity (+1 or -1) | | `anti_flag` | int64 | Anti-particle flag | | `is_self_conjugate` | bool | Whether particle is its own antiparticle | | `lifetime_ns` | float64 | Lifetime (nanoseconds) | | `ctau_mm` | float64 | Proper decay length c*tau (mm) | ## Quick stats - **6,506** particles in the database - **6,431** with measured mass - **522** with measured width - **88** self-conjugate particles - Heaviest particle: **Ds273** (254,437 MeV) ## Usage ```python from datasets import load_dataset ds = load_dataset("juliensimon/pdg-particle-properties", split="train") df = ds.to_pandas() # All mesons (PDG ID 100-999) mesons = df[(df["pdg_id"].abs() >= 100) & (df["pdg_id"].abs() < 1000)] # Mass spectrum plot import matplotlib.pyplot as plt masses = df[df["mass_mev"].notna()]["mass_mev"] plt.hist(masses[masses < 5000], bins=100, log=True) plt.xlabel("Mass (MeV/c^2)") plt.ylabel("Count") plt.title("Particle Mass Spectrum") # Stable particles (no measured width) stable = df[df["width_mev"].isna() & df["mass_mev"].notna()] # Heaviest particles heaviest = df.sort_values("mass_mev", ascending=False).head(20) ``` ## Data source [Particle Data Group](https://pdg.lbl.gov/) (PDG), via the [`particle`](https://pypi.org/project/particle/) Python package. ## Update schedule Annual (August 1) via [GitHub Actions](https://github.com/juliensimon/space-datasets). ## Pipeline Source code: [juliensimon/space-datasets](https://github.com/juliensimon/space-datasets) ## Citation ```bibtex @dataset{pdg_particle_properties, author = {Simon, Julien}, title = {PDG Particle Properties}, year = {2026}, publisher = {Hugging Face}, url = {https://huggingface.co/datasets/juliensimon/pdg-particle-properties}, note = {Based on Particle Data Group (PDG) data via the particle Python package} } ``` ## License [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/)许可证：CC-BY-4.0 数据集显示名称："PDG粒子属性" 语言：英语 数据集描述：收录粒子数据组（Particle Data Group, PDG）的全部已知粒子——这是所有粒子物理学家公认的权威参考标准。 任务类别：表格分类、表格回归 标签：物理学、粒子物理、PDG、标准模型、高能物理、开放数据 数据规模分类：n<1000 # PDG粒子属性   收录粒子数据组（Particle Data Group, PDG）的全部已知粒子，当前共计**6506**个粒子。 ## 数据集说明 粒子数据组（PDG）是全球粒子物理学家所使用的粒子物理性质的权威参考标准。本数据集提供了PDG粒子列表的机器可读版本，涵盖所有已知的基本粒子、强子与原子核的质量、衰变宽度、寿命、量子数以及衰变性质等信息。 本数据集的数据来源于`particle` Python包，该包可通过编程方式便捷获取完整且经过清洗的PDG数据集。 ## 数据结构 | 列名 | 数据类型 | 描述 | |--------|------|-------------| | `pdg_id` | int64 | PDG蒙特卡洛粒子编号 | | `name` | string | 粒子名称（例如"π+"、"K*(892)⁰"） | | `latex_name` | string | LaTeX格式名称 | | `mass_mev` | float64 | 粒子质量（单位：MeV/c²） | | `mass_uncertainty_mev` | float64 | 质量的不确定度上限（单位：MeV/c²） | | `width_mev` | float64 | 衰变宽度（单位：MeV） | | `width_uncertainty_mev` | float64 | 衰变宽度的不确定度上限（单位：MeV） | | `charge` | float64 | 电荷量（单位为元电荷e） | | `spin` | float64 | 自旋角动量J | | `parity` | Int64 | 宇称P（取值为+1或-1） | | `isospin` | string | 同位旋I | | `g_parity` | Int64 | G宇称（取值为+1或-1） | | `c_parity` | Int64 | C宇称（取值为+1或-1） | | `anti_flag` | int64 | 反粒子标记 | | `is_self_conjugate` | bool | 该粒子是否为自身的反粒子 | | `lifetime_ns` | float64 | 粒子寿命（单位：纳秒） | | `ctau_mm` | float64 | 固有衰变长度c*τ（单位：毫米） | ## 快速统计 - **6506**个粒子收录于数据库 - **6431**个粒子带有有效质量测量值 - **522**个粒子带有有效衰变宽度测量值 - **88**个为自共轭粒子 - 最重粒子：**Ds273**（质量达254437 MeV） ## 使用示例 python from datasets import load_dataset ds = load_dataset("juliensimon/pdg-particle-properties", split="train") df = ds.to_pandas() # 筛选所有介子（PDG编号绝对值介于100至999之间） mesons = df[(df["pdg_id"].abs() >= 100) & (df["pdg_id"].abs() < 1000)] # 绘制粒子质量谱图 import matplotlib.pyplot as plt masses = df[df["mass_mev"].notna()]["mass_mev"] plt.hist(masses[masses < 5000], bins=100, log=True) plt.xlabel("质量（MeV/c²）") plt.ylabel("粒子计数") plt.title("粒子质量谱") # 筛选稳定粒子（未测量到衰变宽度） stable = df[df["width_mev"].isna() & df["mass_mev"].notna()] # 按质量降序排列，取前20个最重的粒子 heaviest = df.sort_values("mass_mev", ascending=False).head(20) ## 数据来源 [粒子数据组（PDG）](https://pdg.lbl.gov/)，通过[`particle`](https://pypi.org/project/particle/) Python包获取。 ## 更新计划 每年8月1日通过[GitHub Actions](https://github.com/juliensimon/space-datasets)执行更新。 ## 数据流水线 源代码仓库：[juliensimon/space-datasets](https://github.com/juliensimon/space-datasets) ## 引用格式 bibtex @dataset{pdg_particle_properties, author = {Simon, Julien}, title = {PDG粒子属性}, year = {2026}, publisher = {Hugging Face}, url = {https://huggingface.co/datasets/juliensimon/pdg-particle-properties}, note = {基于粒子数据组（PDG）公开数据，通过particle Python包整理获取} } ## 许可证 [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/)