# Create and activate environment
conda create -n dedalus3
conda activate dedalus3
(Apple Silicon only) There are currently upstream issues in scipy that prevent Dedalus from natively running on arm64 at this time.
If you are using a Mac with an Apple Silicon processor, you will need to instruct the environment to use x86 packages:
# Macs with Apple Silicon only!
conda config --env --set subdir osx-64
We strongly recommend disabling threading when running Dedalus for maximum performance on all platforms.
The conda environment can be configured to do this automatically:
# Disable threading in the environment (strongly recommended for performance)
conda env config vars set OMP_NUM_THREADS=1
conda env config vars set NUMEXPR_MAX_THREADS=1
Install Dedalus v2 and all its requirements from the conda-forge channel and upgrade to Dedalus v3 using pip:
# Install Dedalus v2 from conda-forge to build stack
conda install -c conda-forge dedalus c-compiler "h5py=*=mpi*" "cython<3.0"
# Upgrade to Dedalus v3
conda uninstall --force dedalus
CC=mpicc pip3 install --no-cache --no-build-isolation http://github.com/dedalusproject/dedalus/zipball/master/
To use Dedalus, you simply need to activate the new environment.
You can test the installation using the command-line interface:
conda activate dedalus3
python3 -m dedalus test
The Dedalus package within the environment can be updated using pip as described below.
Custom conda installation
Alternatively, you can use a build script that will create a custom conda environment with all dependencies and then install Dedalus via pip.
This script allows you to optionally link against custom MPI/FFTW/HDF5 libraries, which may provide better performance on some clusters.
Install conda on your system if you don’t already have it (we recommend the miniforge variant).
Download the Dedalus v3 conda installation script from this link or using:
curl https://raw.githubusercontent.com/DedalusProject/dedalus_conda/master/conda_install_dedalus3.sh --output conda_install_dedalus3.sh
Modify the options at the top of the script to change the name of the resulting conda environment, link against custom MPI/FFTW/HDF5 libraries, choose between OpenBLAS and MKL-based numpy/scipy, and more.
Activate the base conda environment and run the script to build a new conda environment with Dedalus and its dependencies, as requested:
conda activate base
bash conda_install_dedalus3.sh
To use Dedalus, you simply need to activate the new environment.
You can test the installation using the command-line interface:
conda activate dedalus3
python3 -m dedalus test
The Dedalus package within the environment can be updated using pip as described below.
Installing the Dedalus package
To install the Dedalus package, you must first have the necessary C and Python 3 dependencies.
The required C packages are MPI, FFTW, and HDF5.
In your Python 3 environment, you need mpi4py and h5py linked to your MPI and HDF5 installations (see the mpi4py and h5py docs for details).
The other Python 3 build requirements are numpy, setuptools, wheel, and cython<3.0 (note the strict Cython version requirement), which can all be installed via pip:
pip3 install --upgrade numpy setuptools wheel "cython\<3.0"
You can then install Dedalus from the PyPI distributions or the source repository, as described below.
Note: the instructions in this section assume the pip3 command is hitting the right Python 3 installation.
You can check this by making sure that which pip3 and which python3 reside in the same location.
If not, use python3 -m pip instead of pip3 in the following commands.
Note: it is strongly recommended that you disable threading, as described on the Performance Tips page, when running Dedalus.
This is done automatically when Dedalus is installed using the conda build script described above, but must be done manually otherwise.
Installing from PyPI
Note: Dedalus v3 is currently under beta-release, and not yet available on PyPI.
Please build directly from source as described below.
Building from source
To build and install the most recent version of Dedalus v3, first set the MPI_PATH and FFTW_PATH environment variables to your prefix paths for MPI and FFTW:
export MPI_PATH=/path/to/your/mpi_prefix
export FFTW_PATH=/path/to/your/fftw_prefix
You can then install Dedalus directly from GitHub using pip, ensuring that the C extensions are properly linked to MPI by using mpicc:
CC=mpicc pip3 install --no-cache --no-build-isolation http://github.com/dedalusproject/dedalus/zipball/master/
Alternatively, you can clone the master branch from the source repository and install locally using pip:
git clone -b master https://github.com/DedalusProject/dedalus
cd dedalus
CC=mpicc pip3 install --no-cache --no-build-isolation .
Updating Dedalus
If Dedalus was installed using the conda script or from GitHub with pip, it can also be updated using pip:
CC=mpicc pip3 install --upgrade --force-reinstall --no-deps --no-cache --no-build-isolation http://github.com/dedalusproject/dedalus/zipball/master/
If Dedalus was built from a clone of the source repository, first pull new changes and then reinstall with pip:
cd /path/to/dedalus/repo
git pull
CC=mpicc pip3 install --upgrade --force-reinstall --no-deps --no-cache --no-build-isolation .
Note: any custom FFTW/MPI paths set in the conda script or during the original installation will also need to be exported for the upgrade commands to work.
Uninstalling Dedalus
Dedalus can be uninstalled using:
