Skip to content

ORNL-Fusion/xolotl

Folders and files

NameName
Last commit message
Last commit date
Nov 19, 2024
Jan 22, 2025
Jan 22, 2025
Jun 22, 2020
Sep 27, 2023
Oct 28, 2024
May 27, 2020
Jan 22, 2025
Jun 23, 2023
Dec 5, 2024
Jan 30, 2025
Mar 14, 2023
Jan 30, 2025
Aug 17, 2020
Nov 14, 2024
Feb 3, 2025
Oct 25, 2024
Feb 3, 2025

Repository files navigation

Xolotl

Xolotl is a continuum simulator under development within two DOE SciDAC programs, available at https://github.com/ORNL-Fusion/xolotl . It is a high-performance computing code using advection-reaction-diffusion (ADR) kinetic rate theory to model the time evolution of the divertor material in next generation tokamaks like ITER, as well as nuclear fuel in fission reactors.

Required Dependencies

  • C++17 compiler
  • CMake >= 3.13
  • MPI
  • Boost
  • Kokkos >= 4.4
  • HDF5
  • PETSc >= 3.16 (configured with kokkos and kokkos-kernels; see scripts/build_petsc.sh)

Quick-Start Install

Xolotl can now build all dependencies (using PETSc's build system) during the CMake configure step:

cd $HOME
git clone https://github.com/ORNL-Fusion/xolotl $HOME/xolotl-source
mkdir $HOME/xolotl-build
cd $HOME/xolotl-build
cmake \
    -DXolotl_BUILD_PETSC=ON \
    [-DXolotl_ENABLE_CUDA=ON | -DXolotl_ENABLE_OPENMP=ON] \
    -DCMAKE_BUILD_TYPE=Release \
    -DCMAKE_INSTALL_PREFIX=$HOME/xolotl-build/install \
    $HOME/xolotl-source/
make
make test
make install

If Boost, HDF5, or LAPACK are not found during configuration, they will automatically be requested from PETSc's build system. Or you can specify this directly via -DXolotl_BUILD_BOOST=ON, etc.

If you wish to configure and install PETSc separately, use (or reference) our PETSc build script.

Wiki

You can find more information about this code on our Wiki and how to install Xolotl and its dependencies in Build Configuration.

Once installed, you can use a Benchmark file to run the code:

./xolotl <input_parameter_file> 

as described in Running Xolotl, with the description of the different options at Parameter File and PETSc Options.

More Info

If you want to contribute please check Guidelines.

A list of publications using Xolotl is available at Publications.

For any question you can send an email to our mailing list: xolotl-psi-development@lists.sourceforge.net.