Metadata-Version: 2.4
Name: scarabee
Version: 0.1.1
Summary: A lattice physics code for LWR analysis.
Keywords: lattice physics,reactor physics,neutron transport,LWR
Author-Email: Hunter Belanger <hunter.belanger@gmail.com>
License-Expression: LGPL-3.0-or-later
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Project-URL: homepage, https://scarabee.readthedocs.io/en/latest/
Project-URL: documentation, https://scarabee.readthedocs.io/en/latest/
Project-URL: source, https://github.com/scarabee-dev/scarabee
Requires-Python: >=3.10
Requires-Dist: numpy
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-check; extra == "test"
Requires-Dist: pytest-timeout; extra == "test"
Description-Content-Type: text/markdown

# Scarabée
[![Documentation Status](https://readthedocs.org/projects/scarabee/badge/?version=latest)](https://scarabee.readthedocs.io/en/latest/?badge=latest)
[![License](https://img.shields.io/badge/License-LGPLv3-brightgreen)](https://github.com/HunterBelanger/scarabee/blob/master/LICENSE)

Scarabée is a simplified lattice physics code for light water reactor (LWR)
neutronics calculations. It currently has the following features:

* Resonance self-shielding according to Carlvik's 2-term rational approximation
* 1D Annular pin cell collision probabilities solver for fixed-source and k-eigenvalue problems
* 2D Method of characteristics solver for fixed-source and k-eigenvalue problems
* Finite difference diffusion solver for 1D, 2D, and 3D fixed-source and k-eigenvalue problems
* Nodal expansion method diffusion solver for 3D k-eigenvalue problems
* PWR lattice calculations with depletion

This project closely follows the methods outlined in *Methods of Steady-State
Reactor Physics in Nuclear Design* by Stamm'ler and Abbate, and *Lattice
Physics Computations* by Knott and Yamamoto, from the *Handbook of Nuclear
Engineering*, edited by D. Cacuci, and *Applied Reactor Physics* by Hébert.

Scarabée uses a custom HDF5 formated nuclear data library which is easy and
intuitive to understand. The `data` directory contains a helper library and
scripts to generate a multi-group nuclear data library with the FRENDY nuclear
data processing code. FRENDY is free/open-source software, and can be downloaded
[here](https://rpg.jaea.go.jp/main/en/program_frendy/). Currently, only FRENDY
is supported, due to its advanced multi-group processing features.
