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
    • Pulse shape simulation settings
    • Energy resolution model defaults
    • A/E resolution model defaults
    • A/E mean energy-dependence model
    • PSD cut defaults
    • Current pulse model defaults
    • Superpulse settings
    • Electronics-response model defaults
    • HPGe modeling settings
    • Manual HPGe skip-list
• Pipeline steps
  • vtx — event vertex generation
  • stp — particle simulation
  • par — parameter extraction
    • Parameter source resolution
    • HPGe energy resolution
    • HPGe A/E resolution
    • HPGe PSD cuts
    • HPGe current-pulse model
    • HPGe modeling criteria and skip-list
    • Pulse-shape library (PSL) chain
    • HPGe drift-time maps
    • Ideal HPGe pulse-shape library
    • Data superpulses
    • HPGe electronics-response model
    • Realistic HPGe pulse-shape library
  • opt — optical hit building
  • hit — hit tier building
    • HPGe observable validation
  • 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
  • par tier — HPGe PSD parameter files
  • par tier — detector-info cache (pars/detinfo/)
  • 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