Skip to content

DOC: remove very outdated info on ATLAS #29119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 3, 2025
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
DOC: remove very outdated info on ATLAS
ATLAS hasn't been developed for years, there is no reason to ever
use it instead of OpenBLAS, BLIS, or MKL. So remove mentions of it.
The troubleshooting instructions haven't been relevant in quite a
while either.

Addresses a comment on gh-29108

[skip cirrus] [skip github] [skip azp]
  • Loading branch information
rgommers committed Jun 3, 2025
commit 7fb327b253aad943824a9538b17f2d3e80c63a53
12 changes: 2 additions & 10 deletions INSTALL.rst
Original file line number Diff line number Diff line change
Expand Up @@ -135,23 +135,15 @@ For best performance, a development package providing BLAS and CBLAS should be
installed. Some of the options available are:

- ``libblas-dev``: reference BLAS (not very optimized)
- ``libatlas-base-dev``: generic tuned ATLAS, it is recommended to tune it to
the available hardware, see /usr/share/doc/libatlas3-base/README.Debian for
instructions
- ``libopenblas-base``: fast and runtime detected so no tuning required but a
very recent version is needed (>=0.2.15 is recommended). Older versions of
OpenBLAS suffered from correctness issues on some CPUs.
- ``libopenblas-base``: (recommended) OpenBLAS is performant, and is what all
the NumPy wheels on PyPI are built with

The package linked to when numpy is loaded can be chosen after installation via
the alternatives mechanism::

update-alternatives --config libblas.so.3
update-alternatives --config liblapack.so.3

Or by preloading a specific BLAS library with::

LD_PRELOAD=/usr/lib/atlas-base/atlas/libblas.so.3 python ...


Build issues
============
Expand Down
22 changes: 0 additions & 22 deletions doc/source/user/troubleshooting-importerror.rst
Original file line number Diff line number Diff line change
Expand Up @@ -83,28 +83,6 @@ on how to properly configure Eclipse/PyDev to use Anaconda Python with specific
conda environments.


Raspberry Pi
------------

There are sometimes issues reported on Raspberry Pi setups when installing
using ``pip3 install`` (or ``pip`` install). These will typically mention::

libf77blas.so.3: cannot open shared object file: No such file or directory


The solution will be to either::

sudo apt-get install libatlas-base-dev

to install the missing libraries expected by the self-compiled NumPy
(ATLAS is a possible provider of linear algebra).

*Alternatively* use the NumPy provided by Raspbian. In which case run::

pip3 uninstall numpy # remove previously installed version
apt install python3-numpy


Debug build on Windows
----------------------

Expand Down
Loading
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy