Skip to content

F.A.Q.

tl;dr

Here we collect the most frequent questions that might occur. Please, make sure to inspect this section before filing a GitHub issue.

Code usage

I want to have a custom boundary/injection/driving/distribution function/output.

All of that can be done via the tools provided by the problem generator. Please inspect carefully the section dedicated to that.

Technical

Running in a docker container with an AMD card

AMD has a vary brief documentation on the topic. In theory the docker containers that come with the code should work. Just make sure you have the proper groups (render and video) defined and added to the current user. If it complains about access to /dev/kfd, You might have to run docker as a root.

Compilation errors

Before merging with the released stable version, the code is tested on CUDA and HIP GPU compilers, as well as few version of CPU compilers (GCC 9...11, and LLVM 13...17). If you are encountering compiler errors on GPUs, first thing to check is whether the compilers are set up properly (i.e., whether CMake indeed captures the right compilers). Here are a few tips:

  • CUDA @ NVIDIA GPUs: make sure you have a version of gcc which is supported by the version of CUDA you are using; check out this unofficial compatibility matrix. In particular, Intel compilers are not very compatible with CUDA, and it is recommended to use gcc instead (you won't gain much by using Intel anyway, since CUDA will be doing the heavy-lifting).

  • HIP/ROCm @ AMD GPUs: ROCm library is a headache. The documentation is even more so. We have a dedicated section specifically discussing compilation with HIP. Make sure to check it before opening an issue.