diff options
author | joaopfg <jfontesgoncalves@gmail.com> | 2022-07-07 23:06:43 +0200 |
---|---|---|
committer | joaopfg <jfontesgoncalves@gmail.com> | 2022-07-07 23:06:43 +0200 |
commit | c94e84162a996d11415ce1a7add0d5e700ff9c6f (patch) | |
tree | 104afca60b0c1e26a251c5c108d5d716d513775a /doc/source/user | |
parent | 43b666c9296b24bc072f13e43dd2c605b6e659d2 (diff) | |
download | numpy-c94e84162a996d11415ce1a7add0d5e700ff9c6f.tar.gz |
Adding docs about the C-API incompatibility error and pointing to the docs in the error
Diffstat (limited to 'doc/source/user')
-rw-r--r-- | doc/source/user/troubleshooting-importerror.rst | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/source/user/troubleshooting-importerror.rst b/doc/source/user/troubleshooting-importerror.rst index 1f99491a1..7809ae386 100644 --- a/doc/source/user/troubleshooting-importerror.rst +++ b/doc/source/user/troubleshooting-importerror.rst @@ -146,3 +146,21 @@ following in python:: This may mainly help you if you are not running the python and/or NumPy version you are expecting to run. + + +C-API incompatibility +--------------------------- + +If you see this error you may have: + +* A bad extension "wheel" (binary install) that should use `oldest-support-numpy <https://pypi.org/project/oldest-supported-numpy/>`_ (with manual constraints if necessary) to build their binary packages. +* An environment issue messing with package versions, or incompatible package versions somehow enforced manually. +* An extension module compiled locally against a very recent version followed by a NumPy downgrade or a compiled extension copied to a different computer with an older NumPy version. + +The best thing to do if you see this error is to contact the maintainers of the package that is causing problem so that they can solve the problem properly. + +However, while you wait for a solution, a work around that usually works is to upgrade the NumPy version: + + + pip install numpy --upgrade + |