Skip to content

UnfoldingUtils class and example macros to solve unfolding problems using ROOT

Notifications You must be signed in to change notification settings

andrewadare/unfolding

Repository files navigation

unfolding.git

C++/ROOT package for unfolding and inference

This package provides many tools for tackling discrete linear inverse problems, including

  • Singular value decomposition and Generalized SVD
    • Extension of the method described in SVD approach to data unfolding
    • GSVD provides more regularization flexibility than the classic SVD method, and allows rectangular (m > n) matrices.
    • Error propagation through full covariance matrix
  • Preconditioned conjugate gradients for least squares (P-CGLS)
  • Richardson-Lucy iterative solver
  • $\chi^2$ minimizer using ROOT's TMinuit2 package (requires ROOT to be built with --enable-minuit2)
  • "Fully Bayesian" method using MCMC Metropolis random walk sampler.

Significant attention has been devoted to visualization. The examples produce spectral decomposition plots, step-wise animations for the iterative solvers, and surface plots demonstrating evolution the solutions with regularization strength.

Several quantitative methods are included to assist in finding the optimal regularization strength, including generalized cross-validation, L-curve analysis, effective degrees of freedom, and singular value spectra.

Getting started

There is no build system other than ROOT's ACLiC compiler (see examples/rootlogon.C). This package requires MatrixUtils.h and UtilFns.h from andrewadare/utils. Either symlink them to the same directory as README.md, or add their location to the ACLiC and interpreter include paths by editing examples/rootlogon.C. The example scripts should then work without further setup; for example do $ root ConvolutionExample.C+.

This code has been tested on Mac OS X 10.9 against ROOT 5 (5.34/18) and ROOT 6 beta (5.99/06). Unfortunately, I can't say much about any other setup.

About

UnfoldingUtils class and example macros to solve unfolding problems using ROOT

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published