Installation

SaltProc has the following dependencies:

1. python (>=3.5)

2. serpent (>=2.1.31)

3. serpentTools

4. openmc (>=0.13.0)

5. numpy (>=1.14.0)

6. PyTables

7. networkx

8. pydot

9. jsonschema

Optional Dependencies:

1. pytest (for testing)

2. sphinx and sphinx-rtd-theme (for building documentation)

3. matplotlib

Clone the source from the SaltProc repository from GitHub.

git clone git@github.com:arfc/saltproc.git

Note

We recommend using the mamba CLI tool to install packages quickly. SaltProc has a compltex package dependency structure which can result is long environment solve times in the default conda solver. mamba is a reimplementation of conda in C++ and we have found it is significantly faster.

You can download the required packages using conda on the provided environment.yml file in the repository:

cd saltproc/
conda env create -f environment.yml

Once all the dependencies are installed, SaltProc can be installed by running the following commands from within the cloned directory repository (assuming the saltproc-env environment is active):

pip install .

Please let us know if you run into trouble.

Cross Section Configuration

SaltProc can use any cross section library that its depletion codes can. Currently supported depletion codes and their guides on cross section configuration are listed below:

• Serpent: See this page on the Serpent wiki for information on how to configure the libraries.

• OpenMC: See this page on the OpenMC docs for information on how to configure the libraries. You can also convert a Serpent cross section library to an OpenMC cross section library using their included scripts.

Testing

The SaltProc test suite has two types of tests: unit tests and regression tests. The unit tests check that the individual functions and classes of the saltproc module return the correct type of variables and correct values, where applicable. The regression tests run a full SaltProc simulation and check the final result with a precalculated result. The SerpentDepcode integration tests require the JEFF 3.1.2 cross section library as well as neutron induces and spontaneous fission product yield data from JEFF 3.3. The publicly available versions of JEFF 3.1.2 cannot be used with Serpent right out of the box due to Serpent’s notation for isomeric states. The scripts in scripts/xsdata download all necessary libraries and perform all the necessary processing on them for use in Serpent 2. We recommend using them for your convenience. See the README for more information.

To run the tests, execute:

pytest test/

from the root directory of SaltProc. If you want to just the unit tests, execute:

pytest tests/unit_tests

Similarly, for just the integration tests, execute:

pytest tests/integration_tests

For more precise control, please refer to the pytest documentation.