diff options
| author | Charles Harris <charlesr.harris@gmail.com> | 2020-06-11 13:49:34 -0600 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-06-11 13:49:34 -0600 |
| commit | f1206ddb24d35781328266b2b02fa27e6fbb9846 (patch) | |
| tree | c8dbbaef0dfc43e23f5197ce379fa2aa1d0b984e | |
| parent | 19bc8bbe37044b9f23d80bb282758071d0d8bf15 (diff) | |
| parent | 12c0b0eac8ba4216011634bcec53aad41d129e70 (diff) | |
| download | numpy-f1206ddb24d35781328266b2b02fa27e6fbb9846.tar.gz | |
Merge pull request #16452 from mattip/accelerate-error
DOC,ENH: extend error message when Accelerate is detected
| -rw-r--r-- | doc/source/user/building.rst | 12 | ||||
| -rw-r--r-- | numpy/__init__.py | 9 | ||||
| -rw-r--r-- | site.cfg.example | 8 |
3 files changed, 16 insertions, 13 deletions
diff --git a/doc/source/user/building.rst b/doc/source/user/building.rst index 47a0a03c9..6a880b59e 100644 --- a/doc/source/user/building.rst +++ b/doc/source/user/building.rst @@ -6,6 +6,10 @@ Building from source A general overview of building NumPy from source is given here, with detailed instructions for specific platforms given separately. +.. + This page is referenced from numpy/numpy/__init__.py. Please keep its + location in sync with the link there. + Prerequisites ------------- @@ -159,6 +163,14 @@ will prefer to use ATLAS, then OpenBLAS and as a last resort MKL. If neither of these exists the build will fail (names are compared lower case). +.. deprecated:: 1.20 + The native libraries on macOS, provided by Accelerate, are not fit for use + in NumPy since they have bugs that cause wrong output under easily reproducible + conditions. If the vendor fixes those bugs, the library could be reinstated, + but until then users compiling for themselves should use another linear + algebra library or use the built-in (but slower) default, see the next + section. + Disabling ATLAS and other accelerated libraries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/numpy/__init__.py b/numpy/__init__.py index e6a24f0d1..1c3b11844 100644 --- a/numpy/__init__.py +++ b/numpy/__init__.py @@ -279,12 +279,11 @@ else: error_message = "{}: {}".format(w[-1].category.__name__, str(w[-1].message)) msg = ( "Polyfit sanity test emitted a warning, most likely due " - "to using a buggy Accelerate backend. " - "If you compiled yourself, " - "see site.cfg.example for information. " + "to using a buggy Accelerate backend. If you compiled " + "yourself, more information is available at " + "https://numpy.org/doc/stable/user/building.html#accelerated-blas-lapack-libraries " "Otherwise report this to the vendor " - "that provided NumPy.\n{}\n".format( - error_message)) + "that provided NumPy.\n{}\n".format(error_message)) raise RuntimeError(msg) del _mac_os_check diff --git a/site.cfg.example b/site.cfg.example index 3eba3bbd7..c809303a2 100644 --- a/site.cfg.example +++ b/site.cfg.example @@ -242,14 +242,6 @@ # library_dirs = C:\Program Files (x86)\IntelSWTools\compilers_and_libraries_2018\windows\mkl\lib\intel64 # libraries = mkl_rt -# Accelerate -# ---------- -# Accelerate/vecLib is an OSX framework providing a BLAS and LAPACK implementation. -# -# [accelerate] -# libraries = Accelerate, vecLib -# #libraries = None - # UMFPACK # ------- # The UMFPACK library is used in scikits.umfpack to factor large sparse matrices. |