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.
Light emission from muons and electrons comes from a small neural network (SIREN) trained on Geant4 photon tables from PhotonSim, so running LUCiD does not need Geant4. Units are metres, nanoseconds and MeV.
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.pngInstallation covers GPU builds and the optional extras, and
the quickstart goes through this example and its gradient.
examples/ has scripts for calibration, reconstruction, a neutrino
telescope and multi-particle events. New Geant4 datasets are produced with PhotonSim, locally,
in the ghcr.io/cider-ml/lucid container or on a cluster
(producing datasets).
https://cider-ml.github.io/LUCiD/, built from docs/. The paper's figures are
reproduced from analysis/paper/.
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).
CITATION.cff has the same reference in machine-readable form.
Copyright 2024-2026 the LUCiD authors. The code is under the Apache License 2.0; the
data release assets (scripts/download_data.py) are under CC BY 4.0.
Third-party material keeps its own terms (THIRD_PARTY.md).
