Skip to content
CIDeR-MLPublic

About

No description, website, or topics provided.

Resources

Stars

13 stars

Watchers

4 watching

Forks

Repository files navigation

LUCiD

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.

Per-PMT charge from a muon in a cylindrical, a spherical and a box detector, from Geant4 photons and from LUCiD's prediction

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

Installation 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).

Documentation

https://cider-ml.github.io/LUCiD/, built from docs/. The paper's figures are reproduced from analysis/paper/.

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).

CITATION.cff has the same reference in machine-readable form.

Licence

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).

About

No description, website, or topics provided.

Resources

Stars

13 stars

Watchers

4 watching

Forks

Releases

Packages

Contributors

Languages