@@ -516,10 +516,33 @@ Other API Changes
516
516
517
517
Deprecations
518
518
~~~~~~~~~~~~
519
+
519
520
- :func:`read_excel()` has deprecated ``sheetname`` in favor of ``sheet_name`` for consistency with ``.to_excel()`` (:issue:`10559`).
520
521
- ``pd.options.html.border`` has been deprecated in favor of ``pd.options.display.html.border`` (:issue:`15793`).
521
522
- :func:`SeriesGroupBy.nth` has deprecated ``True`` in favor of ``'all'`` for its kwarg ``dropna`` (:issue:`11038`).
522
523
- :func:`DataFrame.as_blocks` is deprecated, as this is exposing the internal implementation (:issue:`17302`)
524
+ - ``pd.TimeGrouper`` is deprecated in favor of :class:`pandas.Grouper` (:issue:`16747`)
525
+
526
+ .. _whatsnew_0210.deprecations.argmin_min
527
+
528
+ Series.argmax and Series.argmin
529
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
530
+
531
+ - The behavior of :func:`Series.argmax` has been deprecated in favor of :func:`Series.idxmax` (:issue:`16830`)
532
+ - The behavior of :func:`Series.argmin` has been deprecated in favor of :func:`Series.idxmin` (:issue:`16830`)
533
+
534
+ For compatibility with NumPy arrays, ``pd.Series`` implements ``argmax`` and
535
+ ``argmin``. Since pandas 0.13.0, ``argmax`` has been an alias for
536
+ :meth:`pandas.Series.idxmax`, and ``argmin`` has been an alias for
537
+ :meth:`pandas.Series.idxmin`. They return the *label* of the maximum or minimum,
538
+ rather than the *position*.
539
+
540
+ We've deprecated the current behavior of ``Series.argmax`` and
541
+ ``Series.argmin``. Using either of these will emit a ``FutureWarning``. Use
542
+ :meth:`Series.idxmax` if you want the label of the maximum. Use
543
+ ``Series.values.argmax()`` if you want the position of the maximum. Likewise for
544
+ the minimum. In a future release ``Series.argmax`` and ``Series.argmin`` will
545
+ return the position of the maximum or minimum.
523
546
524
547
.. _whatsnew_0210.prior_deprecations:
525
548
@@ -636,7 +659,7 @@ Sparse
636
659
637
660
- Bug in ``SparseSeries`` raises ``AttributeError`` when a dictionary is passed in as data (:issue:`16905`)
638
661
- Bug in :func:`SparseDataFrame.fillna` not filling all NaNs when frame was instantiated from SciPy sparse matrix (:issue:`16112`)
639
-
662
+ - Bug in :func:`SparseSeries.unstack` and :func:`SparseDataFrame.stack` (:issue:`16614`, :issue:`15045`)
640
663
641
664
Reshaping
642
665
^^^^^^^^^
0 commit comments