Using Dedalus

Dedalus is "A flexible framework for spectrally solving differential equations."[1]

Our research servers have version 3-beta(from the Git master branch of 19 May 2020).

More information is available here:

• https://dedalus-project.org/
• https://dedalus-project.readthedocs.io/en/latest/
• https://github.com/DedalusProject/dedalus/

Setting up the environment

1. Log in to a research server or Linux workstation.
2. Run: source /usr/local/dedalus/init
3. You will see that the prompt is prefixed with '(dedalus3)'.
4. You can now run Python3 code using the Dedalus modules.

Notes

As per the Dedalus documentation the following environment variables will be set when the Dedalus environment is activated:

   OMP_NUM_THREADS=1
   NUMEXPR_MAX_THREADS=1

See:

• https://www.openmp.org/spec-html/5.0/openmpse50.html
• https://numexpr.readthedocs.io/projects/NumExpr3/en/latest/user_guide.html#threadpool-configuration

This could have an effect on other code/applications you might run from the Dedalus environment.

FAQ

I think there is a problem with the installation

The first thing you should do is to run the regression tests that are built in to Dedalus. Depending on the outcome you may want to contact IT to investigate.

To run the tests do this:

pytest --workers=1 -k 'not ncc' /usr/local/dedalus/miniconda3/envs/dedalus3/lib/python3.10/site-packages/dedalus/tests/