How gundam-organization/gundam works
GUNDAM is a configurable neutrino-analysis and fitting framework. Users provide YAML/JSON configuration and data inputs; dataset loading prepares samples, parameters and dial definitions drive event reweighting, and likelihood evaluation feeds fit/minimization and analysis outputs. The map preserves the documented cross-section and oscillation-analysis scope, plus parameter scans, plots, event-tree output and Python access. Several links are dashed because the available excerpts and source index do not establish their runtime call direction.
Main entry points: LikelihoodInterface.cpp Likelihood · PythonInterface.cpp Python interface · FitterEngine.cpp Fitter engine · Propagator.cpp Propagator
Components 18
Inputs and samples
- Dataset definition
src/DatasetManager/include/DatasetDefinition.h - Data dispenser
src/DatasetManager/src/DataDispenser.cpp - Sample set
src/SamplesManager/src/SampleSet.cpp
Fit model
- Parameter manager
src/ParametersManager/src/ParametersManager.cpp - Dial engine
src/DialDictionary/DialEngine/src/DialManager.cpp - Event dial cache
src/DialDictionary/DialEngine/include/EventDialCache.h
Statistical inference
- Likelihood
src/StatisticalInference/Likelihood/src/LikelihoodInterface.cpp - Joint probability
src/StatisticalInference/JointProbability/src/JointProbability.cpp - Fitter engine
src/Fitter/Engine/src/FitterEngine.cpp - Minimizers
src/Fitter/Minimizer/src/RootMinimizer.cpp - Parameter scanner
src/StatisticalInference/Likelihood/src/ParameterScanner.cpp
Execution and results
- Propagator
src/Propagator/src/Propagator.cpp - Weight cache
src/CacheManager/src/CacheManager.cpp - Plot generator
src/Propagator/src/PlotGenerator.cpp - Event tree writer
src/Propagator/src/EventTreeWriter.cpp
User interfaces
- Config utilities
src/Utils/src/ConfigUtils.cpp - Python interface
src/PythonInterface/src/PythonInterface.cpp
Other components
- Analyst
Connections 23
- Analyst → Config utilities: provides config
README.md - Config utilities → Dataset definition: configures
- Dataset definition → Data dispenser: owns dispensers
src/DatasetManager/include/DatasetDefinition.h - Data dispenser → Sample set: loads events
- Parameter manager → Dial engine: supplies parameters
- Dial engine → Event dial cache: builds event cache
- Propagator → Parameter manager: uses parameters
- Propagator → Sample set: reweights samples
- Propagator → Event dial cache: uses dial cache
- Weight cache → Sample set: updates samples
src/CacheManager/src/CacheManager.cpp - Weight cache → Event dial cache: updates weights
src/CacheManager/src/CacheManager.cpp - Likelihood → Propagator: evaluates model
- Likelihood → Joint probability: computes probability
- Fitter engine → Likelihood: fits likelihood
- Fitter engine → Minimizers: selects minimizer
src/Fitter/Engine/src/FitterEngine.cpp - Fitter engine → Weight cache: uses weight cache
src/Fitter/Engine/src/FitterEngine.cpp - Parameter scanner → Likelihood: scans parameters
- Likelihood → Plot generator: exposes plotting
- Likelihood → Event tree writer: exposes event output
- Analyst → Python interface: uses Python API
- Python interface → Fitter engine: accesses fitting
src/PythonInterface/src/PythonInterface.cpp - Python interface → Dataset definition: accesses datasets
src/PythonInterface/src/PythonInterface.cpp - Python interface → Parameter manager: accesses parameters
src/PythonInterface/src/PythonInterface.cpp