Dedalus provides an all-in-one installation script that will build an isolated stack containing a Python installation and the other dependencies needed to run Dedalus. In most cases, the script can be modified to link with system installations of FFTW, MPI, and linear algebra libraries.
You can get the installation script from this link, or download it using:
and execute it using:
The installation script has been tested on a number of Linux distributions and OS X. If you run into trouble using the script, please get in touch on the user list.
Dedalus primarily relies on the basic components of a scientific Python stack using Python 3. Below are instructions for building the dependency stack on a variety of machines and operating systems:
- Install notes for Mac OS X (10.9)
- Install notes for TACC/Stampede
- Install notes for NASA/Pleiades
- Install notes for NASA/Discover
- Install notes for PSC/Bridges: Intel stack
- Install notes for Trestles
- Install notes for CU/Janus
- Install notes for BRC HPC SAVIO cluster
- Install notes for MIT Engaging Cluster
Dedalus is distributed using the mercurial version control system, and hosted on Bitbucket. To install Dedalus itself, first install mercurial, and then clone the main repository using:
hg clone https://bitbucket.org/dedalus-project/dedalus
Move into the newly cloned repository, and use pip to install any remaining Python dependencies with the command:
pip3 install -r requirements.txt
To help Dedalus find the proper libraries, it may be necessary to set the
MPI_PATH environment variables (see system-specific documentation).
Dedalus’s C-extensions can then be built in-place using:
python3 setup.py build_ext --inplace
Finally, add the repository directory to your
PYTHONPATH environment variable to ensure that the
dedalus package within can be found by the Python interpreter.
To update your installation of Dedalus, move into the repository directory (located at
src/dedalus within the installation script’s build, or where you manually cloned it) and issue the mercurial update commands:
hg pull hg update
Then rerun the pip requirements installation and python build, in case the dependencies or C-extensions have changes:
pip3 install -r requirements.txt python3 setup.py build_ext --inplace
Dedalus should be updated.