Skip to content

legend-exp/legend-simflow

Repository files navigation

legend-simflow

legend-simflow logo

PyPI GitHub tag (latest by date) GitHub Workflow Status pre-commit Codecov Read the Docs GitHub issues GitHub pull requests License

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:

About

Snakemake workflow for orchestration of large-scale simulations for LEGEND

Resources

License

Stars

0 stars

Watchers

1 watching

Forks

Contributors