From 794a6c4511ced84c74bc8f2dd8cd8f277925a6ac Mon Sep 17 00:00:00 2001
From: Pauli Virtanen <pav@iki.fi>
Date: Thu, 10 Dec 2009 19:12:41 +0000
Subject: ENH: emit ComplexWarning when casting complex to real (addresses
 #1319)

Casting complex numbers to real discards the imaginary part, which may
be unexpected. For safety, emit a warning when this occurs.
---
 doc/release/1.5.0-notes.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

(limited to 'doc/release')

diff --git a/doc/release/1.5.0-notes.rst b/doc/release/1.5.0-notes.rst
index 7a22620c8..42254b789 100644
--- a/doc/release/1.5.0-notes.rst
+++ b/doc/release/1.5.0-notes.rst
@@ -2,7 +2,36 @@
 NumPy 1.5.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)
-- 
cgit v1.2.1