This contains the primary public repository for the BAND framework project.

The Bayesian Analysis for Nuclear Dynamics (BAND) software Framework provides tools and examples that facilitate principled Uncertainty Quantification in Nuclear Physics.

This framework is funded by the NSF Office of Advanced Cyberinfrastructure, Cyberinfrastructure for Sustained Scientific Innovation program, under grant OAC-2004601.

We provide tools and examples that demonstrate how

• emulation of computationally expensive models,
• model calibration, and
• Bayesian model mixing

can be combined in order to provide a full accounting of the uncertainties in Nuclear Physics models–-including model uncertainty.

These tools are designed to:

• enable predictions with full UQ for experimentally inaccessible environments such as neutron stars.
• when combined with code that implements Bayesian experimental design methodology, permit a quantitative assessment of the impact of proposed experiments.

More about the goals and structure of the BAND project can be found in D.R. Phillips et al., "Get on the BAND Wagon: a Bayesian framework for quantifying model uncertainties in nuclear dynamics", J. Phys. G 48 (2021) 7, 072001.

A full list of BAND members together with a current list of publications produced by the members using the tools and ideas of the project is available at https://bandframework.github.io.

BAND Framework elements are of two main types:

• BAND tools: these are pieces of python code that can be invoked to perform specific emulation, calibration, model-mixing, experimental-design, or linkage functions.
• BAND examples: these are notebooks that provide examples of principled Bayesian uncertainty quantification. They are constructed to solve a particular nuclear-physics problem, but contain software that BAND Framework users may wish to adapt to other scientific contexts.

Framework elements can be found in software/.

As of version 0.4.0, the following tools are available:

• surmise (v0.3.0): A surrogate model interface for calibration, uncertainty quantification, and sensitivity analysis.
• SmoothEmulator: A simplex sampler, emulator trainer, and MCMC explorer that employs a smooth emulator.
• parMOO (v0.4.1): A Python library for parallel multiobjective simulation optimization.
• rose (v1.1.3): A reduced-order scattering emulator.
• Taweret (v1.1.0): A Python package containing multiple Bayesian Model Mixing methods.
• PUQ (v0.1.0): A Python package for generating experimental designs tailored for uncertainty quantification and featuring parallel implementations.

The following examples are part of version 0.4.0:

• Bfrescox: A BAND extension of the frescox scattering code for coupled-channels calculations that uses surmise.
• BMEX (v0.1.1): A web application for exploring quantified theoretical model predictions of nuclear masses and related quantities.
• BRICK: The Bayesian R-matrix Inference Code Kit, designed to facilitate extraction of R-matrix parameters from experimental data.
• jitr (v2.0.1): A Python package containing a Lagrange mesh R-matrix solver for parametric reaction model calibration.
• nsat: A Bayesian mixture model approach to quantifying the empirical nuclear saturation point.
• QGP_Bayes: A tutorial on the use of JETSCAPE_SIMS tools to infer parameters of the QGP.
• SaMBA (v1.1.0): The Sandbox for Mixing via Bayesian Analysis.

You are free to use any pieces of the BAND Framework that will advance your own research. Please cite the framework, and the original BAND paper, as detailed below under "Citing the BAND Framework".

BAND Framework currently includes some dependencies via git submodules. Currently, the following submodules are employed:

• software/nuclear_saturation
• software/QGP_Bayes
• software/rose
• software/SAMBA
• software/surmise
• software/Taweret
• software/jitr

As a consequence, when cloning the BAND Framework repository, the submodules can be retrieved automatically via

• git clone --recursive (in place of the usual git clone)

If you have already cloned the repository, the following modified git commands can be used:

• git submodule update --init --recursive (to obtain all submodules and any submodules those submodules have)
• git pull --recurse-submodules=yes (in place of the usual git pull)
• git submodule update --init (additionally, after git pull)
• git submodule update --init software/surmise (variant of the previous item, in case you want to only get the surmise submodule)

Note that submodules work on modern git (i.e., version >= 2.38.0).

BAND welcomes contributions to the BAND Framework in a variety of forms; please see CONTRIBUTING.

The BAND Framework maintains a BAND Software Development Kit (SDK) that includes requirements and recommendations for contributing a package to the BAND Framework.

Detailed instructions for contributing software, including by submodules, are found in BAND's developer's guide.

All code included in the BAND Framework is open source, with the particular form of license contained in the top-level subdirectories of software/. If such a subdirectory does not contain a LICENSE file, then it is automatically licensed as described in the otherwise encompassing BAND Framework LICENSE.

Please use the following to cite the BAND Framework:

@techreport{bandframework,
    title       = {{BANDFramework: An} Open-Source Framework for {B}ayesian Analysis of Nuclear Dynamics},
    author      = {Kyle Beyer and Landon Buskirk and Moses Y-H. Chan and Tyler H. Chang and Richard James DeBoer and Christian Drischler and 
    Richard J. Furnstahl and Pablo Giuliani and Kyle Godbey and Kevin Ingles and Dananjaya Liyanage and Filomena M. Nunes and 
    Daniel Odell and Jared O'Neal and Daniel R. Phillips and Matthew Plumlee and Matthew T. Pratola and 
    Scott Pratt and Oleh Savchuk and Alexandra C. Semposki and \"Ozge S\"urer and 
    Stefan M. Wild and John C. Yannotty},
    institution = {},
    number      = {Version 0.4.0},
    year        = {2024},
    url         = {https://github.com/bandframework/bandframework}
}

If possible, please also cite the original BAND Framework paper:

@article{Phillips:2020dmw,
    author = "Phillips, D. R. and others",
    title = "{Get on the BAND Wagon: A Bayesian Framework for Quantifying Model Uncertainties in Nuclear Dynamics}",
    eprint = "2012.07704",
    archivePrefix = "arXiv",
    primaryClass = "nucl-th",
    doi = "10.1088/1361-6471/abf1df",
    journal = "J. Phys. G",
    volume = "48",
    number = "7",
    pages = "072001",
    year = "2021"
}

Please also cite any of the underlying BAND Framework packages you employ, each of which includes citation or documentation information.

For more information, please see the BAND framework website.

Our release process is also provided.