User manual

• Installation and configuration
  • The configuration file
  • Software dependencies
• Data names and paths
  • File naming conventions
• Metadata
  • tier/ static tier configuration
    • vtx tier
    • stp tier
    • Run partitioning
    • opt tier
    • hit tier
    • evt tier
    • cvt tier
    • pdf tier
  • pars/ — simulation parameters
    • Drift time map settings
    • Energy resolution model defaults
    • A/E resolution model defaults
    • PSD cut defaults
    • Current pulse model defaults
    • Manual HPGe skip-list
• Pipeline steps
  • vtx — event vertex generation
  • stp — particle simulation
  • par — parameter extraction
    • HPGe energy resolution (extract_hpge_observables_models)
    • HPGe A/E resolution (extract_hpge_observables_models)
    • HPGe PSD cuts (extract_hpge_observables_models)
    • HPGe current pulse model (extract_current_pulse_model)
    • Manual HPGe skip-list
  • opt — optical hit building
  • hit — hit tier building
    • HPGe observable validation (build_tier_hit)
  • evt — event building
    • simprod/config/tier/evt/{experiment}/settings.yaml — evt tier settings
  • cvt — event concatenation
  • pdf — PDF generation
• Production
  • Running tier scripts standalone
  • Selective step execution with make_steps
  • Benchmarking runs
    • Setup
    • Running
    • Inspecting results
    • Applying the results
• Output tier fields
  • hit tier — HPGe detector post-processing
    • Inherited fields
    • Added fields
  • opt tier — optical (SiPM) post-processing
    • Inherited fields
    • Added fields
  • evt tier — event-level output
    • trigger/ — event metadata
    • geds/ — HPGe detector array
    • spms/ — SiPM (LAr scintillation) array
    • coincident/ — detector coincidence flags
  • Time-coincidence map (TCM)
  • pdf tier — probability density functions
    • Root-level fields
    • pdf/ — histogram struct
    • pdf/fail/ — cut-failure histograms
• Production sites
  • NERSC
    • I/O optimization
    • Multi-node execution
• Tips & Tricks
  • Logging
  • Useful Snakemake CLI options