Skip to main content

​
Detector list

Pass the detector name to LARDON with the -det flag. The eight supported detectors are listed below.

pdhd

ProtoDUNE Horizontal Drift — located at CERN. Uses WIB2 electronics. A large-scale single-phase liquid argon TPC with horizontal electron drift.
  • TPC reconstruction: supported
  • PDS reconstruction: not supported
  • Gallery mode: not supported

pdvd

ProtoDUNE Vertical Drift — located at CERN. A large-scale single-phase liquid argon TPC with vertical electron drift and 4 CRP modules.
  • TPC reconstruction: supported
  • PDS reconstruction: supported
  • Gallery mode: supported (-gallery beam|top|bottom|both)

cbtop

VD Coldbox top — the top readout of the newer VD Coldbox detector. A smaller vertical-drift test stand used for detector R&D.
  • TPC reconstruction: supported
  • PDS reconstruction: not configured
  • Gallery mode: not supported

cbbot

VD Coldbox bottom — the bottom readout of the newer VD Coldbox detector.
  • TPC reconstruction: supported
  • PDS reconstruction: supported
  • Gallery mode: not supported

cb1top

VD Coldbox 1 top — the top readout of the older VD Coldbox 1 detector.
  • TPC reconstruction: supported
  • PDS reconstruction: not configured
  • Gallery mode: not supported

cb1bot

VD Coldbox 1 bottom — the bottom readout of the older VD Coldbox 1 detector.
  • TPC reconstruction: supported
  • PDS reconstruction: not configured
  • Gallery mode: not supported

dp

Dual Phase prototype — an earlier dual-phase liquid argon TPC prototype.
  • TPC reconstruction: supported
  • PDS reconstruction: not configured (no PDS fields in geo.json)
  • Gallery mode: not supported

50l

50-liter prototype — a small 50-litre liquid argon TPC used for electronics and reconstruction studies.
  • TPC reconstruction: supported
  • PDS reconstruction: not configured
  • Gallery mode: not supported

​
PDS reconstruction support

PDS reconstruction (-pds) processes photon detector signals alongside the TPC data. PDS detector geometry and channel maps are configured for the following detectors:
  • pdvd
  • cbbot
PDS reconstruction is not supported for pdhd. Passing -pds with -det pdhd will produce incorrect or missing PDS output. Use only -trk for PDHD data.
Gallery mode (-gallery) renders data using an effective channel mapping so that tracks appear continuous rather than broken across readout boundaries. It produces visual images rather than reconstruction output files.
Gallery mode is only available for pdvd. Passing -gallery with any other detector causes LARDON to exit.
The four gallery options are:
ValueDescription
beamShows only channels relevant to the beam track, zoomed around the expected beam arrival time
topShows the top drift volume
bottomShows the bottom drift volume
bothProduces two separate images — one for the top and one for the bottom volume
To suppress axis tick and channel number labels (e.g. for conference figures), set self.conference_style = True in src/lardon/gallery/pdvd.py.

​
Coordinate conventions

LARDON uses a consistent coordinate system across all detectors.
  • Drift axis: electrons drift along the z-axis (the third axis).
  • Units: all spatial coordinates are in cm.
The origin placement depends on the detector type:
Detector(s)Origin
pdhd, pdvd (ProtoDUNE-II)Matches the LArSoft convention
cbtop, cbbot, cb1top, cb1bot, 50lAt the centre of the detector

​
Configuring data paths

Each detector has a path.json file under src/lardon/settings/<detector>/ that lists the directories where LARDON looks for raw HDF5 files. LARDON searches:
  • The top-level directory listed in path.json
  • Hashed subdirectories: /directory/ha/sh/
  • Run-number subdirectories: /directory/runnumber/ and /directory/ru/nu/mb/er
Before running LARDON on a new machine or data location, check and update path.json for your detector. If the raw file cannot be found automatically, use the -hash flag to specify the hashed subdirectory, or use -file to provide the full path directly.

Build docs developers (and LLMs) love

Get started for freeTalk to us