Skip to main content
LARDON is a Python-based reconstruction framework for liquid argon time projection chamber (LArTPC) detector data. It processes raw HDF5 readout files from DUNE and ProtoDUNE detectors, performing signal processing, noise filtering, hit finding, and 2D/3D track reconstruction for both the charge (TPC) and light (PDS) readout systems.

Installation

Install LARDON and its dependencies using Pixi on Linux or macOS.

Quickstart

Run your first reconstruction in minutes with a worked example.

Command Reference

Full reference for every CLI flag and option LARDON accepts.

Reconstruction Pipeline

Understand how LARDON processes raw data into reconstructed tracks.

​
What LARDON does

LARDON takes raw detector data from supported LArTPC detectors and produces fully reconstructed physics objects stored in HDF5 output files. The reconstruction pipeline covers:
  • Signal processing — pedestal estimation, FFT low-pass filtering, coherent noise removal, and microphonic noise suppression
  • 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 and clusters light signals
  • TPC–PDS matching — correlates reconstructed charge tracks with light clusters for full event reconstruction

​
Supported detectors

ProtoDUNE-HD

pdhd — ProtoDUNE Horizontal Drift detector at CERN

ProtoDUNE-VD

pdvd — ProtoDUNE Vertical Drift detector at CERN

VD Coldbox

cbtop / cbbot / cb1top / cb1bot — Vertical Drift Coldbox detectors

50L & Dual Phase

50l / dp — smaller prototype detectors

​
Get started

1

Install Pixi

Install the Pixi package manager, which manages all LARDON dependencies.
curl -fsSL https://pixi.sh/install.sh | sh
2

Install LARDON

Clone the repository and install all environments.
git clone https://github.com/dune-lardon/lardon.git
cd lardon
pixi install -a
3

Configure your environment

Set the required environment variables by sourcing the setup script.
source set_lardon.sh
4

Run reconstruction

Launch LARDON on a PDVD run with TPC reconstruction enabled.
lardon -det pdvd -run 39229 -sub 24 -flow 4 -writer 0 -serv 5 -hash 86/ad -event 11 -trk

Build docs developers (and LLMs) love

Get started for freeTalk to us