SOLAR Documentation

SOLAR is the analysis and reconstruction toolkit used to study solar-neutrino signals from DUNE SolarNuAna_module outputs. The repository combines staged detector workflow studies with higher-level physics analyses such as Day-Night asymmetry, HEP searches, fiducial optimization, and oscillation sensitivity scans.

The current codebase is organized around:

• staged reconstruction drivers in src/workflow/, src/preselection/, src/PDS/, src/TPC/, and src/vertex/

• truth-level weighting and background preparation in src/truth/

• analysis orchestration in src/analysis/

• shared utilities in lib/

• central defaults in import/analysis.json

Recent repository developments reflected in these docs include config-driven Gaussian smoothing, shared fiducial-optimization helpers, and regression tests for the smoothing pipeline.

Contents

• Installation
  • Clone The Repository
  • Python Environment
  • Data Access
  • Build The Documentation
• Tutorial
  • 1. Prepare Inputs
  • 2. Run The Full Reconstruction Chain
  • 3. Run The High-Level Solar Analyses
  • 4. Inspect Outputs
  • 5. Validate New Smoothing Behaviour
• Workflow Guide
  • Detector And Reconstruction Stages
  • Truth And Weighting Stages
  • Solar Analysis Stages
  • Shared Configuration
  • HEP Profile-Likelihood Updates
  • Orchestrator Flags
  • Component Policy In Analysis Orchestration
• Development Notes
  • Key Repository Paths
  • Current Validation
  • Building Docs
  • Practical Notes
• lib package
  • Core modules
  • Notes

Quick Start

Clone the repository and create a Python environment:

git clone https://github.com/CIEMAT-Neutrino/SOLAR.git
cd SOLAR
python3 -m venv .venv
source .venv/bin/activate
pip install -r docs/requirements.txt

Run the full staged detector chain for one sample:

python3 src/00All.py --config hd_1x2x6_centralAPA --name marley

Run the current high-level solar analysis driver:

python3 src/analysis/10SensitivityAnalysis.py \
  --config hd_1x2x6_centralAPA \
  --names marley gamma neutron \
  --analysis DayNight HEP Sensitivity \
  --folder Reduced

Indices and tables

• Index

• Module Index

• Search Page