juliensimon/crdb-cosmic-ray-spectra

---
license: cc-by-4.0
pretty_name: "Cosmic Ray Database (CRDB)"
language:
- en
description: "Cosmic Ray Database — ALL cosmic ray measurements from 131 experiments and 504 papers. Energy spectra, flux measurements, and metadata for every published cosmic ray observation."
task_categories:
- tabular-regression
tags:
- physics
- cosmic-ray
- crdb
- high-energy
- particle
- open-data
size_categories:
- 100K<n<1M
---

# Cosmic Ray Database (CRDB)


Complete cosmic ray spectral database from [CRDB](https://lpsc.in2p3.fr/crdb/) —
**6,837** measurements across **32** particle types from
**65** experiments.

## Dataset description

The Cosmic Ray Database (CRDB) compiles all published cosmic ray measurements,
including energy spectra and flux data from ground-based detectors, balloon
experiments, and space missions. It is the reference database for cosmic ray
physics, maintained by D. Maurin et al. at LPSC Grenoble.

## Schema

| Column | Type | Description |
|--------|------|-------------|
| `particle` | string | Particle/nucleus type (e.g. "H", "He", "e-") |
| `experiment` | string | Experiment name (e.g. "AMS-02", "PAMELA") |
| `sub_exp` | string | Sub-experiment or detector |
| `energy_min_gev_n` | float | Energy bin lower edge (GeV/n) |
| `energy_max_gev_n` | float | Energy bin upper edge (GeV/n) |
| `flux` | float | Measured flux |
| `error_low` | float | Lower error on flux |
| `error_high` | float | Upper error on flux |
| `reference` | string | Publication reference |
| `ads_url` | string | ADS bibliographic URL |
| `is_usable` | bool | Whether the data point is recommended for use |

## Quick stats

- **6,837** measurements
- **32** particle types
- **65** experiments

## Usage

```python
from datasets import load_dataset

ds = load_dataset("juliensimon/crdb-cosmic-ray-spectra", split="train")
df = ds.to_pandas()

# Proton spectrum from AMS-02
ams02_p = df[(df["particle"] == "H") & (df["experiment"] == "AMS-02")]
print(f"{len(ams02_p):,} AMS-02 proton data points")

# All experiments for a given particle
import matplotlib.pyplot as plt
protons = df[df["particle"] == "H"]
for exp, grp in protons.groupby("experiment"):
e_mid = (grp["energy_min_gev_n"] + grp["energy_max_gev_n"]) / 2
plt.scatter(e_mid, grp["flux"], s=1, label=exp, alpha=0.5)
plt.xscale("log"); plt.yscale("log")
plt.xlabel("Energy (GeV/n)"); plt.ylabel("Flux")
plt.title("Proton Cosmic Ray Spectrum")
```

## Data source

[CRDB — Cosmic Ray DataBase](https://lpsc.in2p3.fr/crdb/) (Maurin et al.)

All data retrieved via the `crdb` Python package.

## Update schedule

Quarterly (1st of Jan/Apr/Jul/Oct at 06:00 UTC) via [GitHub Actions](https://github.com/juliensimon/space-datasets).

## Related datasets

- [juliensimon/auger-cosmic-rays](https://huggingface.co/datasets/juliensimon/auger-cosmic-rays) — Pierre Auger Observatory events

## Pipeline

Source code: [juliensimon/space-datasets](https://github.com/juliensimon/space-datasets)

## Citation

```bibtex
@dataset{crdb_cosmic_ray_spectra,
author = {Simon, Julien},
title = {Cosmic Ray Database (CRDB)},
year = {2026},
publisher = {Hugging Face},
url = {https://huggingface.co/datasets/juliensimon/crdb-cosmic-ray-spectra},
note = {Based on CRDB (Maurin et al.) via lpsc.in2p3.fr/crdb}
}
```

## License

[CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/)