summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPauli Virtanen <pav@iki.fi>2019-12-01 15:41:25 +0200
committerPauli Virtanen <pav@iki.fi>2019-12-01 15:41:25 +0200
commit3892cad45c6318a5828ea2a80c896ac648c293fc (patch)
tree216ed30c8bf98731b21f42d0d994d083c3f94eb8 /doc
parent33a2fcb4aebba8f80fdf12a7ecef879a3aaa0e63 (diff)
downloadnumpy-3892cad45c6318a5828ea2a80c896ac648c293fc.tar.gz
DOC: document NPY_USE_BLAS64_ environment variable
Diffstat (limited to 'doc')
-rw-r--r--doc/source/user/building.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/source/user/building.rst b/doc/source/user/building.rst
index b4b4371e5..8e2b5c03b 100644
--- a/doc/source/user/building.rst
+++ b/doc/source/user/building.rst
@@ -195,6 +195,25 @@ or::
BLAS=None LAPACK=None ATLAS=None python setup.py build
+64-bit BLAS and LAPACK with symbol suffix
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Numpy also supports 64-bit OpenBLAS with ``64_`` symbol suffix. Such
+library is obtained by compiling OpenBLAS with settings::
+
+ make INTERFACE64=1 SYMBOLSUFFIX=64_
+
+To make Numpy use it, set ``NPY_USE_BLAS64_=1`` environment variable
+when building Numpy. You may also need to configure the
+``[openblas64_]`` section in ``site.cfg``.
+
+The symbol suffix avoids symbol name clashes between 32-bit and 64-bit
+BLAS/LAPACK libraries, meaning that you can link to both in the same
+program. This avoids potential issues when using 64-bit BLAS/LAPACK in
+Numpy while simultaneously using other Python software that uses the
+32-bit versions.
+
+
Supplying additional compiler flags
-----------------------------------