Skip to content

Commit 031d1d1

Browse files
committed
Add threading tips
1 parent ddeacb0 commit 031d1d1

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/pages/performance_tips.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,16 @@
33
Performance Tips
44
****************
55

6+
Stack Configuration
7+
===================
8+
9+
Disable multithreading
10+
----------------------
11+
12+
Dedalus does not fully implement hybrid parallelism, so the best performance is typically seen when there is one MPI process for each available core.
13+
Some underlying stack components (e.g. Numpy or Scipy or the libraries they wrap) may still attempt to use multiple threads behind the scenes, though, and this can substantially degrade performance.
14+
We therefore recommend explicitly disabling threading by setting environment variables such as ``OMP_NUM_THREADS`` to ``1`` before running Dedalus.
15+
616
Domain Specification
717
====================
818

0 commit comments

Comments
 (0)