Skip to content

LUCiD

LUCiD (Light-based Unified Calibration and trackIng Differentiable simulation) is a differentiable photon simulator for optical particle detectors: water Cherenkov tanks, water-based liquid scintillator (WbLS) and ice. It is written in JAX, so the gradient of a loss on the sensor output flows back through emission, propagation, scattering and sensor response. Calibration and track reconstruction are then gradient-based fits on the same forward model. Light emission comes from SIREN emitters, small neural networks trained on GEANT4 photon tables.

Units are metres, nanoseconds and MeV throughout.

The method and its results are in End-to-end Differentiable Calibration and Reconstruction for Optical Particle Detectors, arXiv:2602.24129. The project has a home page.

Where to start

I want to Read
install it and see an event Install, then the quickstart
run it on my detector Model your own detector and the bundled detectors
reconstruct a track Reconstruction
calibrate optical parameters Calibration
redraw the paper's figures Paper figures
produce a labelled GEANT4 dataset Producing datasets
look up an argument, config key or output field Reference

Cite

If you use LUCiD, cite the paper above. CITATION.cff has the reference.