Analysis Module

The spine.ana module contains the analysis layer that runs after reconstruction, construction, and post-processing. It is intended for configuration-driven studies of reconstruction quality, detector performance, and physics-facing event content.

Analysis scripts and performance evaluation tools.

This module provides high-level analysis capabilities for neutrino physics reconstruction results, building upon the output of the ML reconstruction chain and post-processing modules.

Core analysis management:

AnaManager orchestrates configuration-driven analysis workflows.

Analysis categories:

Reconstruction-performance studies for PID, energy, spatial, angular, and vertex metrics.
Physics analyses for topology, interaction type, and selection optimization.
Quality-assessment workflows for truth matching, completeness, and systematic studies.

Output products:

Histograms, resolution studies, efficiency curves, and publication-ready figures.

Example

from spine.ana import AnaManager

ana = AnaManager(config_file="analysis.yaml")
results = ana.analyze(input_files, output_dir)
ana.plot_performance(results)

This module serves as the final step in the SPINE reconstruction pipeline, transforming raw ML outputs into physics-ready analysis results.

Module Index

Use this package when the goal is to turn reconstructed SPINE outputs into metrics, derived tables, plots, or physics-study inputs.

`base`	Base class of all analysis scripts.
`manager`	Manages the operation of analysis scripts.
`template`	Analysis module template.
`factories`	Construct an analysis script module class from its name.
`calib`	Calibration analysis scripts.
`diag`	Diagnostic analaysis scripts.
`metric`	Reconstruction quality evaluation module.