Validation Plots - DUNE/dune-tms GitHub Wiki

Running Validation Scripts

The validation scripts are currently being developed on the kleykamp_validation branch. To use them:

  1. Setup the kleykamp_validation branch of dune-tms according to Software Installation and Dependencies
  2. Navigate to the scripts/Validation directory.
  3. Run setup.sh to set up DUNE plotting utilities.
  4. Execute run_validation.sh with the following arguments:
./run_validation.sh <input tmsreco.root file> <n events> <n event displays>

Upon completion, the output will be stored in a directory structured like this:

/exp/dune/data/users/$USER/dune-tms/Validation/Tracking_Validation/<input filename>.root
<input filename>_images

# Inside the images directory
# special has a selection of important plots like reco eff, charge id
├── basic                # Plots of raw branches
├── charge_id            # Plots related to charge ID
├── energy_resolution    # Energy resolution plots
├── EventDisplays        # All event displays
├── event_rates          # Event rate counts for TMS events, lar events, rock muons (incomplete)
├── nd_physics_cut       # Plots related to the nd physics cut
├── reco_eff             # Reco eff vs enter KE and angle, multi-reco checks
├── reco_track           # track cleanliness/completeness, primary/secondary pdg, track start/endpoint resolution
├── resolution           # Plots related to individual hit resolution on tracks
├── special              # a selection of important plots like reco eff, and charge id
└── time_slicing         # Time slice cleanliness and completeness plots

# Inside EventDisplays
├── completeness_cleanliness   # Event displays with suspect slice completeness/cleanliness
├── energy_resolution          # Issues with event resolution
├── first_n_events             # Just the first 500 events
├── issues                     # Misc issues
├── reco_eff                   # Issues with reco efficiency like multi-reco
├── resolution                 # Issues with poor resolution, like poor y resolution
├── single_muon                # First 500 events with single true muons, either throughgoing (all) or tms-ending (tms_end)
└── track_multiplicity         # Event displays with multi-track events

You can find examples of these outputs in /exp/dune/data/users/kleykamp/dune-tms/Validation/Tracking_Validation/.

Example Output from the Special Directory


🧩 Reconstruction Efficiency


⚡ Charge ID


📊 Reconstructed Variables


🎯 Resolution Variables

Energy Resolution

Hit Resolution

Track Resolution


🖼️ Event Display Example

⚠️ **GitHub.com Fallback** ⚠️