Home

DUNE TMS Wiki

Welcome to the dune-tms wiki. This wiki documents the Temporary Muon Spectrometer simulation, reconstruction, output files, validation workflows, and useful datasets.

If you are new, start with the first-run path below. If you are changing code, use the simulation/reconstruction and output-reference pages to understand where things live.

Start here

Goal	Page
Build and run dune-tms for the first time	Tutorial
Install/build on GPVMs, SL7, or locally	Software Installation and Dependencies
Find useful input/output files	Datasets
Get quick answers / troubleshooting pointers	FAQ

Simulation and reconstruction overview

Topic	Page
Detector-simulation model: edep-sim deposits to reconstructed TMS hits	TMS Simulation
Code organization and event-processing flow	dune-tms Primer
Geometry dimensions/versions used for simulation datasets	Geometries for simulation for datasets
ND physics sample cuts and motivation	ND Physics Sample

Output-file reference

Tree / topic	Page
Overview of output ROOT files and which tree to use	Output File Contents
Reconstructed TMS tracks	Reco_Tree
Authoritative particle and vertex truth	Truth_Spill
Reco-to-truth matching summaries	Truth_Info
Hough lines, clusters, and reco debugging	Line_Candidates
Version and geometry provenance	Metadata

Validation and analysis

Task	Page
Check that a code change did not break basic behavior	Validating Changes
Understand reconstruction-validation concepts	Reconstruction Validation
Run or interpret validation plots	Validation Plots
Understand reconstruction-efficiency denominators with spills/time slices	Getting the reco efficiency
Event-display usage	Plotting events / event display
Muon energy-resolution notes	Muon Energy Resolution

Common mental models

Which files should I run on?

For local dune-tms development, use spill-like edep-sim files when possible. See Datasets.

Which tree should I use?

• Use Reco_Tree for reconstructed tracks.
• Use Truth_Spill for full particle and vertex truth.
• Use Truth_Info to connect reconstructed tracks to truth contributors.
• Use Line_Candidates for lower-level reconstruction debugging.
• Use Metadata to check geometry/version provenance.

Who runs production?

Large-scale production should go through the ND production workflow/team. Use GPVMs for development, small tests, and debugging.

Getting help

For questions, ask in the DUNE Slack channel:

#nd_muon_spectrometer

For code-specific questions, #nd_muon_spectrometer_code may also be useful.

When asking for help, include your branch/commit, input file, command, config changes, and the error or unexpected output.