Skip to main content
LARDON (Liquid Argon Reconstruction Done in pythON) is a command-line reconstruction framework for liquid argon time projection chamber (LArTPC) detectors. It reads raw HDF5 readout files produced by DUNE and ProtoDUNE detectors and produces fully reconstructed physics objects — hits, 2D and 3D tracks, and photon detection signals — stored in HDF5 output files. LARDON is used in the DUNE and ProtoDUNE experimental programs at CERN and Fermilab. It supports both the charge readout (TPC) and light readout (PDS) systems, and can process data from a range of detector geometries with a common interface.

What LARDON does

The reconstruction pipeline covers the full chain from raw waveform data to physics objects:
  • Signal processing — pedestal estimation, noise filtering, and coherent noise removal on TPC wire waveforms
  • Hit finding — identifies signal regions of interest on each wire view
  • 2D track reconstruction — Hough-transform-based track seeding with Kalman filter refinement, per detector module
  • 3D track reconstruction — combines 2D tracks from multiple wire views into 3D space points
  • PDS reconstruction — processes photon detection system waveforms, finds peaks, and clusters light signals
  • TPC–PDS matching — correlates reconstructed charge tracks with light clusters for full event reconstruction

Supported detectors

LARDON supports the following detector configurations, specified with the -det flag:
Detector keyDescription
pdvdProtoDUNE Vertical Drift (CERN)
pdhdProtoDUNE Horizontal Drift (CERN)
cbtopVD Coldbox — top volume
cbbotVD Coldbox — bottom volume
cb1topVD Coldbox 1 — top volume
cb1botVD Coldbox 1 — bottom volume
50l50L prototype
dpDual Phase prototype
PDS reconstruction is configured for pdvd and cbbot only. It does not work for pdhd, and is not configured for the other coldbox variants or smaller prototypes.

Key capabilities

Installation

Install LARDON and its Pixi-managed dependencies on Linux or macOS.

Quickstart

Run your first reconstruction in under 5 minutes with a worked example.

Command reference

Full reference for every CLI flag LARDON accepts.

Reconstruction pipeline

Understand how LARDON processes raw data into reconstructed tracks.

Dependency management with Pixi

LARDON uses Pixi to manage its Python dependencies and environments. Pixi resolves and installs all required packages — including numpy, scipy, numba, h5py, scikit-learn, and xrootd — in isolated, reproducible environments. You do not need an existing Python installation or conda environment to use LARDON. Pixi handles everything.
If you previously installed xrootd via conda, remove it before using LARDON. See the installation guide for details.

Build docs developers (and LLMs) love