NumPy 1.26.0 Release Notes#

The NumPy 1.26.0 release is a continuation of the 1.25.x release cycle with the addition of Python 3.12.0 support. Python 3.12 dropped distutils, consequently supporting it required finding a replacement for the setup.py/distutils based build system NumPy was using. We have chosen to use the Meson build system instead, and this is the first NumPy release supporting it. This is also the first release that supports Cython 3.0 in addition to retaining 0.29.X compatibility. Supporting those two upgrades was a large project, over 100 files have been touched in this release. The changelog doesn’t capture the full extent of the work, special thanks to Ralf Gommers, Sayed Adel, Stéfan van der Walt, and Matti Picus who did much of the work in the main development branch.

The highlights of this release are:

  • Python 3.12.0 support.

  • Cython 3.0.0 compatibility.

  • Use of the Meson build system

  • Updated SIMD support

  • f2py fixes, meson and bind(x) support

  • Support for the updated Accelerate BLAS/LAPACK library

The Python versions supported in this release are 3.9-3.12.

New Features#

Array API v2022.12 support in numpy.array_api#

  • numpy.array_api now full supports the v2022.12 version of the array API standard. Note that this does not yet include the optional fft extension in the standard.

(gh-23789)

Support for the updated Accelerate BLAS/LAPACK library#

Support for the updated Accelerate BLAS/LAPACK library, including ILP64 (64-bit integer) support, in macOS 13.3 has been added. This brings arm64 support, and significant performance improvements of up to 10x for commonly used linear algebra operations. When Accelerate is selected at build time, the 13.3+ version will automatically be used if available.

(gh-24053)

meson backend for f2py#

f2py in compile mode (i.e. f2py -c) now accepts the --backend meson option. This is the default option for Python 3.12 on-wards. Older versions will still default to --backend distutils.

To support this in realistic use-cases, in compile mode f2py takes a --dep flag one or many times which maps to dependency() calls in the meson backend, and does nothing in the distutils backend.

There are no changes for users of f2py only as a code generator, i.e. without -c.

(gh-24532)

bind(c) support for f2py#

Both functions and subroutines can be annotated with bind(c). f2py will handle both the correct type mapping, and preserve the unique label for other C interfaces.

Note: bind(c, name = 'routine_name_other_than_fortran_routine') is not honored by the f2py bindings by design, since bind(c) with the name is meant to guarantee only the same name in C and Fortran, not in Python and Fortran.

(gh-24555)

Improvements#

iso_c_binding support for f2py#

Previously, users would have to define their own custom f2cmap file to use type mappings defined by the Fortran2003 iso_c_binding intrinsic module. These type maps are now natively supported by f2py

(gh-24555)

Build system changes#

In this release, NumPy has switched to Meson as the build system and meson-python as the build backend. Installing NumPy or building a wheel can be done with standard tools like pip and pypa/build. The following are supported:

  • Regular installs: pip install numpy or (in a cloned repo) pip install .

  • Building a wheel: python -m build (preferred), or pip wheel .

  • Editable installs: pip install -e . --no-build-isolation

  • Development builds through the custom CLI implemented with spin: spin build.

All the regular pip and pypa/build flags (e.g., --no-build-isolation) should work as expected.

NumPy-specific build customization#

Many of the NumPy-specific ways of customizing builds have changed. The NPY_* environment variables which control BLAS/LAPACK, SIMD, threading, and other such options are no longer supported, nor is a site.cfg file to select BLAS and LAPACK. Instead, there are command-line flags that can be passed to the build via pip/build’s config-settings interface. These flags are all listed in the meson_options.txt file in the root of the repo. Detailed documented will be available before the final 1.26.0 release; for now please see the SciPy “building from source” docs since most build customization works in an almost identical way in SciPy as it does in NumPy.

Build dependencies#

While the runtime dependencies of NumPy have not changed, the build dependencies have. Because we temporarily vendor Meson and meson-python, there are several new dependencies - please see the [build-system] section of pyproject.toml for details.

Troubleshooting#

This build system change is quite large. In case of unexpected issues, it is still possible to use a setup.py-based build as a temporary workaround (on Python 3.9-3.11, not 3.12), by copying pyproject.toml.setuppy to pyproject.toml. However, please open an issue with details on the NumPy issue tracker. We aim to phase out setup.py builds as soon as possible, and therefore would like to see all potential blockers surfaced early on in the 1.26.0 release cycle.

Contributors#

A total of 20 people contributed to this release. People with a “+” by their names contributed a patch for the first time.

  • @DWesl

  • Albert Steppi +

  • Bas van Beek

  • Charles Harris

  • Developer-Ecosystem-Engineering

  • Filipe Laíns +

  • Jake Vanderplas

  • Liang Yan +

  • Marten van Kerkwijk

  • Matti Picus

  • Melissa Weber Mendonça

  • Namami Shanker

  • Nathan Goldbaum

  • Ralf Gommers

  • Rohit Goswami

  • Sayed Adel

  • Sebastian Berg

  • Stefan van der Walt

  • Tyler Reddy

  • Warren Weckesser

Pull requests merged#

A total of 59 pull requests were merged for this release.

  • #24305: MAINT: Prepare 1.26.x branch for development

  • #24308: MAINT: Massive update of files from main for numpy 1.26

  • #24322: CI: fix wheel builds on the 1.26.x branch

  • #24326: BLD: update openblas to newer version

  • #24327: TYP: Trim down the _NestedSequence.__getitem__ signature

  • #24328: BUG: fix choose refcount leak

  • #24337: TST: fix running the test suite in builds without BLAS/LAPACK

  • #24338: BUG: random: Fix generation of nan by dirichlet.

  • #24340: MAINT: Dependabot updates from main

  • #24342: MAINT: Add back NPY_RUN_MYPY_IN_TESTSUITE=1

  • #24353: MAINT: Update extbuild.py from main.

  • #24356: TST: fix distutils tests for deprecations in recent setuptools…

  • #24375: MAINT: Update cibuildwheel to version 2.15.0

  • #24381: MAINT: Fix codespaces setup.sh script

  • #24403: ENH: Vendor meson for multi-target build support

  • #24404: BLD: vendor meson-python to make the Windows builds with SIMD…

  • #24405: BLD, SIMD: The meson CPU dispatcher implementation

  • #24406: MAINT: Remove versioneer

  • #24409: REL: Prepare for the NumPy 1.26.0b1 release.

  • #24453: MAINT: Pin upper version of sphinx.

  • #24455: ENH: Add prefix to _ALIGN Macro

  • #24456: BUG: cleanup warnings [skip azp][skip circle][skip travis][skip…

  • #24460: MAINT: Upgrade to spin 0.5

  • #24495: BUG: asv dev has been removed, use asv run.

  • #24496: BUG: Fix meson build failure due to unchanged inplace auto-generated…

  • #24521: BUG: fix issue with git-version script, needs a shebang to run

  • #24522: BUG: Use a default assignment for git_hash [skip ci]

  • #24524: BUG: fix NPY_cast_info error handling in choose

  • #24526: BUG: Fix common block handling in f2py

  • #24541: CI,TYP: Bump mypy to 1.4.1

  • #24542: BUG: Fix assumed length f2py regression

  • #24544: MAINT: Harmonize fortranobject

  • #24545: TYP: add kind argument to numpy.isin type specification

  • #24561: BUG: fix comparisons between masked and unmasked structured arrays

  • #24590: CI: Exclude import libraries from list of DLLs on Cygwin.

  • #24591: BLD: fix _umath_linalg dependencies

  • #24594: MAINT: Stop testing on ppc64le.

  • #24602: BLD: meson-cpu: fix SIMD support on platforms with no features

  • #24606: BUG: Change Cython binding directive to “False”.

  • #24613: ENH: Adopt new macOS Accelerate BLAS/LAPACK Interfaces, including…

  • #24614: DOC: Update building docs to use Meson

  • #24615: TYP: Add the missing casting keyword to np.clip

  • #24616: TST: convert cython test from setup.py to meson

  • #24617: MAINT: Fixup fromnumeric.pyi

  • #24622: BUG, ENH: Fix iso_c_binding type maps and fix bind(c)

  • #24629: TYP: Allow binary_repr to accept any object implementing…

  • #24630: TYP: Explicitly declare dtype and generic hashable

  • #24637: ENH: Refactor the typing “reveal” tests using typing.assert_type

  • #24638: MAINT: Bump actions/checkout from 3.6.0 to 4.0.0

  • #24647: ENH: meson backend for f2py

  • #24648: MAINT: Refactor partial load Workaround for Clang

  • #24653: REL: Prepare for the NumPy 1.26.0rc1 release.

  • #24659: BLD: allow specifying the long double format to avoid the runtime…

  • #24665: BLD: fix bug in random.mtrand extension, don’t link libnpyrandom

  • #24675: BLD: build wheels for 32-bit Python on Windows, using MSVC

  • #24700: BLD: fix issue with compiler selection during cross compilation

  • #24701: BUG: Fix data stmt handling for complex values in f2py

  • #24707: TYP: Add annotations for the py3.12 buffer protocol

  • #24718: DOC: fix a few doc build issues on 1.26.x and update spin docs