nuclear-rose 1.1.8

The Reduced-Order Scattering Emulator (rose) is a user-friendly software for building efficient surrogate models for nuclear scattering.

ROSE - The Reduced-Order Scattering Emulator

ROSE makes it easy to build and train a scattering emulator. ROSE enables aspiring graduate students and long-suffering postdocs to emulate nuclear scattering observables with optical potentials, trading negligible amounts of accuracy for orders-of-magnitude gains in speed.

For any bug reports or feature requests, please make use of the Github issues tab on the repository. We also welcome all pull requests for software, documentation, and user-contributed tutorials!

Note:

While this project did lead to a successful emulator, it was found that a particular type of high-fidelity solver is actually more useful in a Bayesian calibration context, which lead to the development of BAND software jitR. Currently, this is what we use for calibration of nuclear reaction models, and is what we recomend.

This repository and the associated publication may still be of interest, so it will remain available, but we will not be maintaining the software package or adding new features. If you want to use ROSE, please feel free to do so, but be aware that it is no longer being actively developed.

The application of model order reduction and emulation to nuclear reactions is still an exciting area of research, so the tool or technique we recommend for Bayesian calibration of reaction models may change in the future!

-- ROSE team

Installation

ROSE is hosted at pypi.org/project/nuclear-rose/. To install as a user, run the following

pip install nuclear-rose.

To install as a developer, clone the repository and run

pip install -e .

from within the project root directory.

Testing

ROSE uses pytest for testing. To run the tests, simply run pytest from the project root directory.

Usage

To emulate an interaction, you will make an Interaction class, or something similar. Then you will typically make a ScatteringAmplitudeEmulator, which will train an emulator to emulate elastic cross sections.

For a full set of examples walking through emulation and calibration, check the tutorials directory.

Documentation

You can also check out the documentation page.

More software

You could even check the other BAND softwares and start combining them to write all your Bayesian papers!

Citation

ROSE, and the theory behind it, were introduced in this publication. If you use ROSE, please cite it like so:

@article{PhysRevC.109.044612,
  title = {ROSE: A reduced-order scattering emulator for optical models},
  author = {Odell, D. and Giuliani, P. and Beyer, K. and Catacora-Rios, M. and Chan, M. Y.-H. and Bonilla, E. and Furnstahl, R. J. and Godbey, K. and Nunes, F. M.},
  journal = {Phys. Rev. C},
  volume = {109},
  issue = {4},
  pages = {044612},
  numpages = {17},
  year = {2024},
  month = {Apr},
  publisher = {American Physical Society},
  doi = {10.1103/PhysRevC.109.044612},
  url = {https://link.aps.org/doi/10.1103/PhysRevC.109.044612}
}

Additionally, as ROSE is part of the BAND software framework, please consider citing the BAND Manifesto.