SCIANTIX is a 0D simulation code developed at Politecnico di Milano, designed to model the behavior of a single grain of nuclear fuel, with a particular focus on fission gas behavior. The code primarily uses physics-based models, which enhances the integration of lower-length scale calculations and improves accuracy over empirical models. The engineering models facilitate the code integration into industrial fuel performance codes.
Currently, SCIANTIX is validated against experimental data for the following phenomena:
- Intragranular gaseous swelling
- Intergranular gaseous swelling
- Helium behavior and release under annealing conditions
- Release of radioactive fission gases
- Formation and evolution of high-burnup structure (HBS) porosity
The validation database is available in the regression folder.
Recommended requirements:
- C++17 compatible compiler (tested: GCC ≥ 9, Clang ≥ 10)
- CMake ≥ 3.6
- Ubuntu ≥ 20.04, MacOS Ventura, Windows 10/11 via WSL2 (tested)
- Obtain the Code: Download the source code by cloning the GitHub repository or by downloading the zip folder.
- Install Dependencies:
- On Ubuntu, run:
sudo apt install build-essential cmake
- On Ubuntu, run:
- Build the Code:
- Create a build directory:
mkdir build - Navigate to the build directory:
cd build - Generate the Makefile with CMake:
cmake .. - Compile the code:
make(to speed up the process using multiple cores, use:make -j)
- Create a build directory:
The compiled executable sciantix.x will be located in the build directory.
The recommended approach for Windows users is to use the Windows Subsystem for Linux (WSL).
- Install WSL:
- Follow the official installation guide.
- Run WSL:
- Open WSL by typing
wslincmd.exeor by launching theUbuntuapplication from the Start menu. - Navigate to the code directory using:
cd /mnt/c/...(replace...with your code directory path).
- Open WSL by typing
- Follow Linux Installation Instructions:
- Proceed with the Linux installation steps starting from step 2.
The code can be coupled with thermo-mechanical fuel performance codes (Zullo G. et al (2024). Journal of Nuclear Materials, 601, 155305.). Here, it is detailed that the code can be compiled as a static library and coupled with TRANSURANUS, distributed by JRC-EC Karlsruhe. To generate SCIANTIX as a static library, in the build folder:
- Generate the Makefile with CMake:
cmake -DCOUPLING_TU=ON .. - Compile the code:
make(ormake -j)
The static library, libsciantix.a, will be located in the build directory.
To run SCIANTIX, execute sciantix.x within the directory containing your input files, or execute ./sciantix.x /path_to_folder_with_input_files/ in the working directory with the executable.
Refer to the Input File Explanation for detailed instructions on input syntax.
Examples of input files can be found in:
- The
regressiondirectory - The
utilities/inputExampledirectory, by running the following Python scripts:
python3 utilities/inputExample/print_input_initial_conditions.py
python3 utilities/inputExample/print_input_scaling_factors.py
python3 utilities/inputExample/print_input_settings.pyTo verify the correct operation of SCIANTIX, run the regression tests:
cd regression
python3 regression.pyTo generate the code documentation, run doxygen in the root directory of the code. The Doxygen software can be installed, e.g., on Linux systems, with sudo apt install doxygen.
Please cite SCIANTIX using the Zenodo DOI associated with the v2.2.1 release:
@software{SCIANTIX_2024,
title = {SCIANTIX},
year = {2024},
publisher = {Zenodo},
doi = {10.5281/zenodo.17748425},
url = {https://doi.org/10.5281/zenodo.17748425}
}We also encourage citing the scientific publications associated with SCIANTIX, listed below and in references/references.md, when relevant.
Citation metadata is also available in the CITATION.cff file.
For a deeper understanding of the SCIANTIX code and its underlying models, refer to the following publications:
@article{Zullo2023,
author = {Zullo, Giovanni and Pizzocri, Davide and Luzzi, Lelio},
title = {The SCIANTIX code for fission gas behaviour: Status, upgrades, separate-effect validation, and future developments},
journal = {Journal of Nuclear Materials},
volume = {587},
pages = {154744},
year = {2023},
issn = {0022-3115},
doi = {10.1016/j.jnucmat.2023.154744},
url = {https://www.sciencedirect.com/science/article/pii/S0022311523005111}
}@article{Pizzocri2020,
author = {Pizzocri, Davide and Barani, Tommaso and Luzzi, Lelio},
title = {SCIANTIX: A new open source multi-scale code for fission gas behaviour modelling designed for nuclear fuel performance codes},
journal = {Journal of Nuclear Materials},
volume = {532},
pages = {152042},
year = {2020},
issn = {0022-3115},
doi = {10.1016/j.jnucmat.2020.152042},
url = {https://www.sciencedirect.com/science/article/pii/S0022311519313868}
}SCIANTIX is developed and maintained by:
- Giovanni Zullo
- Elisa Cappellari
- Giovanni Nicodemo
- Aya Zayat
- Davide Pizzocri
- Lelio Luzzi
Politecnico di Milano, Nuclear Engineering Division.