Installation

SaltProc has the following dependencies:

  1. Python (>=3.5)

  2. Serpent (>=2.1.31)

  3. PyNE (>=0.5.11)

  4. NumPy (>=1.14.0)

  5. PyTables

  6. NetworkX

  7. PyDotPlus

Optional Depenendencies:

  1. pytest (for testing)

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

  3. matplotlib

  4. ViTables

Clone the source from the SaltProc repository from GitHub.

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

All of the dependencies are readily available through the conda package manager.

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 ones 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 Serpent can. See this page on the Serpent wiki for information on how to configure the libraries.

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 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 saltproc/

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

pytest --ignore saltproc/tests/integration_tests saltproc/