Skip to content

Commit 4d1194d

Browse files
committed
add whatsnew more prominent
1 parent fcf774b commit 4d1194d

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

doc/source/whatsnew/v0.23.0.txt

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,6 +225,34 @@ If installed, we now require:
225225
| openpyxl | 2.4.0 | |
226226
+-----------------+-----------------+----------+
227227

228+
.. _whatsnew_0230.api_breaking.deprecate_panel:
229+
230+
Deprecate Panel
231+
^^^^^^^^^^^^^^^
232+
233+
``Panel`` was deprecated in the 0.20.x release, showing as a ``DeprecationWarning``. Using ``Panel`` will now show a ``FutureWarning``. The recommended way to represent 3-D data are
234+
with a ``MultiIndex`` on a ``DataFrame`` via the :meth:`~Panel.to_frame` or with the `xarray package <http://xarray.pydata.org/en/stable/>`__. Pandas
235+
provides a :meth:`~Panel.to_xarray` method to automate this conversion. For more details see :ref:`Deprecate Panel <dsintro.deprecate_panel>` documentation. (:issue:`13563`, :issue:`18324`).
236+
237+
.. ipython:: python
238+
:okwarning:
239+
240+
p = tm.makePanel()
241+
p
242+
243+
Convert to a MultiIndex DataFrame
244+
245+
.. ipython:: python
246+
247+
p.to_frame()
248+
249+
Convert to an xarray DataArray
250+
251+
.. ipython:: python
252+
:okwarning:
253+
254+
p.to_xarray()
255+
228256

229257
Build Changes
230258
^^^^^^^^^^^^^
@@ -289,7 +317,6 @@ Deprecations
289317
- ``Series.valid`` is deprecated. Use :meth:`Series.dropna` instead (:issue:`18800`).
290318
- :func:`read_excel` has deprecated the ``skip_footer`` parameter. Use ``skipfooter`` instead (:issue:`18836`)
291319
- The ``is_copy`` attribute is deprecated and will be removed in a future version (:issue:`18801`).
292-
- ``Panel`` is now a ``FutureWarning``, previsouly a ``DeprecationWarning`` and will be removed in a future version (:issue:`18324`)
293320

294321

295322
.. _whatsnew_0230.prior_deprecations:

0 commit comments

Comments
 (0)