This repository includes FLUNED, a CFD-based tool for the simulation of activated water in fusion installations.
More detail on the usage, installation and testing is provided below.
For additional information contact: mdepietri@ind.uned.es
For user simplicity and because the two tools can be coupled, the tools are to be installed together.
The recommeded way is to use the installation script present in the FLUNED-Repository/installation-script/ folder.
The tools needs to run in a linux environment, the software requirements are OpenFOAM v12 and the packages listed either in the toml file or in the installation script.
The simplest way is to download the script and run it with the following commands:
- Download
wget https://raw.githubusercontent.com/marco-de-pietri/FLUNED-repository/refs/heads/master/installation-script/fluned-repo-install.sh
- Make it executable
chmod +x fluned-repo-install.sh
- Install it
./fluned-repo-install.sh
- Restart shell or source the .bashrc file
source ~/.bashrc
Users can also check the script and, if required, install it with a different workflow or tooling.
FLUNED is a mesh-based tool for the simulation of the transport within water of radio-isotope generated by nuclear fusion neutrons.
The tool takes as input a finished hydro-dynamic simulation performed with the code ANSYS FLUENT or OpenFOAM and creates a passive scalar simulation of the radio-isotope concentration.
For simulating cases of irradiated fluid, the information relative to the radio-isotope generation can be provided through a vtk file or by providing a uniform, constant value.
The physics implemented is rather simple and has some limitations however it has been positively validated for water studies with the experimental neutron and photon data generated in the FNG water activaton experiment run in 2019 (angeloneMeasurementDelayedNeutron2020 [1], nobsComputationalEvaluationN162020 [2])
A paper describing its development and validation can be found in [3]
[1]doi: 10.1016/j.fusengdes.2020.111998
[2]doi: 10.1016/j.fusengdes.2020.111743
[3]doi: 10.1016/j.cpc.2023.108807
The pre/post-processor scripts and the solver are designed to simplify the user simulation process. From the command line in the folder where the Ansys - FLUENT or OpenFOAM files are located the following workflow is recommended.
- Generate the FLUNED input:
fluned -t
-
Modify the input_template file with the appropriate parameters. The file will contain the default values together with the available options.
-
Launch the FLUNED pre-processor:
fluned -i input-file
This will create a folder named as the FLUNED case reported in the input file. The created simulation files follow the OpenFOAM structure, therefore some additional tweaking in the simulation parameters can be done if the user has some previous knowledge of the OpenFOAM code. Thanks to the modularity of the OpenFOAM classes, FLUNED simulations can be natively run in parallel using the appropriate OpenFOAM commands.
- In the FLUNED case folder launch the solver by running:
FLUNED-solver
- Once the simulation is finished, the post-processor can be launched in the simulation folder by running:
flunedPost
A set of tests are present in the tests folder. These cases are very simple and have no physical accuracy, are just meant to test the integrated working of the scripts functionalities. To run these execute the following commands from a bash shell inside the tests folder called FLUNED-Repository/tests-integration
- Run the test suite.
./run_tests.sh
- Run the post processing script for the tests simulations:
./run_post.sh
- Run a script that executes the comparison between the test results and the expected results. This comparison will be written in the test_results file
./eval_results.sh
- Clean the created files
./clean_tests.sh
All the code present in the FLUNED-Repository is open-source software licensed under the GNU GPLv3 license.