LUCiD: differentiable simulation of optical particle detectors

LUCiD (Light-based Unified Calibration and trackIng Differentiable simulation) simulates optical photon transport in particle detectors and is written in JAX. For a particle track or a calibration source it computes the expected charge and hit times on every sensor, together with their derivatives with respect to the track and to the detector's optical parameters. Calibration and track reconstruction then become gradient-based fits to the observed data. It is written for people working on water Cherenkov detectors, water-based liquid scintillator (WbLS) and neutrino telescopes in ice.

Per-sensor charge from a muon in a cylindrical, a spherical and a box detector
Per-sensor charge from a muon in a cylindrical, a spherical and a box detector.

What it does

Getting started

Simulation, calibration and reconstruction need only JAX and a few Python packages. LUCiD is installed from a clone; Python 3.10 with jax 0.6.2 is the tested version.

git clone https://github.com/CIDeR-ML/LUCiD.git && cd LUCiD
python3.10 -m venv .venv && . .venv/bin/activate
pip install -e . -c tests/constraints.txt
python scripts/download_data.py      # SIREN weights and example events, 142 MB
python examples/hello_simulate.py    # one 1 GeV muon, writes hello_simulate.png

The last command takes about a minute on four CPU cores. The installation page covers GPU builds and optional extras, and the quickstart goes through the example and its gradient. The documentation also describes the physics model, the configuration files and the command-line tools.

Citation

If you use LUCiD, please cite:

O. Alterkait, C. Jesús-Valls, R. Matsumoto, P. de Perio, K. Terao, End-to-end Differentiable Calibration and Reconstruction for Optical Particle Detectors, arXiv:2602.24129 (2026).

The repository's CITATION.cff has the same reference in machine-readable form.

Code

The source is at github.com/CIDeR-ML/LUCiD. It is under the Apache License 2.0.