summaryrefslogtreecommitdiff
path: root/doc/release/2.0.0-notes.rst
blob: 06e29de6ba58dcbff0d621b3fed383af3d30ece8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
=========================
NumPy 2.0.0 Release Notes
=========================


Plans
=====

This release has the following aims:

* Python 3 compatibility
* :pep:`3118` compatibility


Highlights
==========


New features
============

Warning on casting complex to real
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Numpy now emits a `numpy.ComplexWarning` when a complex number is cast
into a real number. For example:

    >>> x = np.array([1,2,3])
    >>> x[:2] = np.array([1+2j, 1-2j])
    ComplexWarning: Casting complex values to real discards the imaginary part

The cast indeed discards the imaginary part, and this may not be the
intended behavior in all cases, hence the warning. This warning can be
turned off in the standard way:

    >>> import warnings
    >>> warnings.simplefilter("ignore", np.ComplexWarning)