Installation and advice
As already written in the overview, Fluidfft is organized as a main package provided few Fluidfft Python classes using standard packages (Numpy, pyfftw, Dask, etc.) and plugins which can use other methods, in particular based on C++ classes using more advanced libraries (as pfft and p3dfft).
In this page we focus on installing the base Fluidfft package for Fluidfft >= 0.4.0.
First, ensure that you have a recent Python installed, since Fluidsim requires Python >= 3.9. Some issues regarding the installation of Python and Python packages are discussed in the main documentation of the project.
Installation with pip
Note
We strongly advice to install Fluidfft in a virtual environment. See the official guide Install packages in a virtual environment using pip and venv.
Fluidfft can be installed without compilation with pip
:
pip install pip -U
pip install fluidsim
Installation with conda
conda install fluidfft
Remark on Numpy installed with conda
In anaconda (or miniconda), Numpy installed with conda install numpy
can be
built and linked with MKL (an Intel library). This can be a real plus for
performance since MKL replaces fftw functions by (usually) faster ones but it
has a drawback for fft using the library fftw3_mpi (an implementation of
parallel fft using 1D decomposition by fftw). MKL implements some fftw
functions but not all the functions defined in fftw3_mpi. Since the libraries
are loaded dynamically, if numpy is imported before the fftw_mpi libraries,
this can lead to very bad issues (segmentation fault, only if numpy is imported
before the class!). For security, we prefer to automatically disable the
building of the fft classes using fftw3_mpi when it is detected that numpy uses
the MKL library where some fftw symbols are defined.
To install with anaconda numpy linked with openblas:
conda config --add channels conda-forge
conda install "blas[build=*openblas]" numpy
Environment variables
Fluidfft is sensible at runtime to the environment variable
TRANSONIC_BACKEND
. The Transonic backend is “pythran” by default, but it can
also be set to “python” or “numba”.