legend-simflow

End-to-end Snakemake workflow to run Monte Carlo simulations of signal and background signatures in the LEGEND experiment and produce probability-density functions (pdfs). Configuration metadata (e.g. rules for generating simulation macros or post-processing settings) is stored at legend-simflow-config.

Features

• Tier-based Snakemake workflow taking Geant4 (remage) Monte Carlo events all the way to analysis-ready pdfs.
• Simulated statistics weighted by the livetime of a user-selected list of data taking runs (run partitioning).
• Fully metadata-driven: a production is configured by editing a single YAML file, no code required. Runs locally or on HPC sites through ready-made Snakemake profiles.

Detector response models

Physics and detector models tuned to real LEGEND-200 data and applied during post-processing:

• HPGe energy: per-detector energy scale and measured energy resolution FWHM(E) used to smear the simulated energy.
• HPGe active volume: dead-layer / active-volume model from detector geometry and metadata.
• HPGe pulse shape and PSD: Extraction of the A/E PSD observables based on drift-time maps and ideal pulse-shape libraries computed with SolidStateDetectors.jl. This is combined with an electronics-response model's fitted to data waveforms.
• Liquid-argon scintillation and SiPMs: scintillation photon generation, photoelectron detection sampled from optical maps, per-photoelectron amplitude resolution, and time clustering reproducing the SiPM time response.
• Detector status: per-run usability and PSD-usability flags.
• Event building: time-coincidence maps (TCM) across detectors to group hits into physics events.

Documentation

Full documentation is hosted at legend-simflow.readthedocs.io. Good entry points:

• Overview and key concepts
• Installation and configuration
• Running a production
• Configuration metadata and file naming