next_api_changes/*

MovieWriterRegistry raises RuntimeError when writer not available

If `MovieWriterRegistry` can't find the requested `MovieWriter`, a more helpful

`RuntimeError` message is now raised instead of the previously raised

`KeyError`.

Using strings instead of booleans to control grid and tick visibility is deprecated

Using ``"on"``, ``"off"``, ``"true"``, or ``"false"`` to control grid

and tick visibility has been deprecated. Instead, use normal booleans

(``True``/``False``) or boolean-likes. In the future, all non-empty strings

may be interpreted as ``True``.

Removal of deprecated contouring code

Contouring no longer supports ``legacy`` corner masking.

The deprecated ``ContourSet.vmin`` and ``ContourSet.vmax`` properties have been

removed.

Removal of deprecated features

The ``matplotlib.finance``, ``mpl_toolkits.exceltools`` and

``mpl_toolkits.gtktools`` modules have been removed. ``matplotlib.finance``

remains available at https://github.com/matplotlib/mpl_finance.

The ``mpl_toolkits.mplot3d.art3d.iscolor`` function has been removed.

The ``Axes.get_axis_bgcolor``, ``Axes.set_axis_bgcolor``,

``Bbox.update_from_data``, ``Bbox.update_datalim_numerix``,

``MaxNLocator.bin_boundaries`` methods have been removed.

The ``bgcolor`` keyword argument to ``Axes`` has been removed.

The ``spectral`` colormap has been removed. The ``Vega*`` colormaps, which

were aliases for the ``tab*`` colormaps, have been removed.

``mencoder`` can no longer be used to encode animations.

Passing ``None`` instead of ``"none"`` as format to `~.Axes.errorbar` is no

longer supported.

`Figure.set_figwidth` and `Figure.set_figheight` default forward to True

`matplotlib.Figure.set_figwidth` and `matplotlib.Figure.set_figheight`

had the kwarg `forward=False`

by default, but `Figure.set_size_inches` now defaults to `forward=True`.

This makes these functions conistent.

Do not truncate svg sizes to nearest point

There is no reason to size the SVG out put in integer points, change

to out putting floats for the *height*, *width*, and *viewBox* attributes

of the *svg* element.

Deprecations

The unused and untested ``Artist.onRemove`` and ``Artist.hitlist`` methods have

been deprecated.

Deprecations

When given 2D inputs with non-matching numbers of columns, `~.pyplot.plot`

currently cycles through the columns of the narrower input, until all the

columns of the wider input have been plotted. This behavior is deprecated; in

the future, only broadcasting (1 column to *n* columns) will be performed.

Deprecations

The now unused ``mlab.less_simple_linear_interpolation`` function is

deprecated.

Deprecation of unused methods

The unused ``ContourLabeler.get_real_label_width`` method is deprecated.

Deprecations

The unused ``FigureManagerBase.show_popup`` method is deprecated. This

introduced in e945059b327d42a99938b939a1be867fa023e7ba in 2005 but never built

out into any of the backends.

Removal of unused imports

Many unused imports were removed from the codebase. As a result,

trying to import certain classes or functions from the "wrong" module

(e.g. `~.Figure` from :mod:`matplotlib.backends.backend_agg` instead of

:mod:`matplotlib.figure`) will now raise an `ImportError`.

Deprecations

Using `.pyplot.axes` with an `.Axes` as argument is deprecated. This sets

the current axes, i.e. it has the same effect as `.pyplot.sca`. For clarity

``plt.sca(ax)`` should be preferred over ``plt.axes(ax)``.

Fontsizes less than 1 pt are clipped to be 1 pt.

FreeType doesn't allow fonts to get smaller than 1 pt, so all Agg

backends were silently rounding up to 1 pt. PDF (other vector

backends?) were letting us write fonts that were less than 1 pt, but

they could not be placed properly because position information comes from

FreeType. This change makes it so no backends can use fonts smaller than

1 pt, consistent with FreeType and ensuring more consistent results across

backends.

Deprecation of the ``nbagg.transparent`` rcParam

To control transparency of figure patches in the nbagg (or any other) backend,

directly set ``figure.patch.facecolor``, or the ``figure.facecolor`` rcParam.

Removal of deprecated rcParams

The following deprecated rcParams have been removed:

- ``axes.color_cycle`` (see ``axes.prop_cycle``),

- ``legend.isaxes``,

- ``svg.embed_char_paths`` (see ``svg.fonttype``),

- ``text.fontstyle``, ``text.fontangle``, ``text.fontvariant``,

``text.fontweight``, ``text.fontsize`` (renamed to ``text.style``, etc.),

- ``tick.size`` (renamed to ``tick.major.size``).

`~.tight_layout.auto_adjust_subplotpars` now raises `ValueError` instead of `RuntimeError` when sizes of input lists don't match

Deprecation of backend_tkagg.AxisMenu

The above-mentioned class is deprecated, as it has become unused since the

removal of "classic" toolbars.

Changes to Qt backend class MRO

To support both Agg and cairo rendering for Qt backends all of the

non-Agg specific code previously in

:class:`.backend_qt5agg.FigureCanvasQTAggBase` has been moved to

:class:`.backend_qt5.FigureCanvasQT` so it can be shared with the cairo

implementation. The :meth:`.FigureCanvasQTAggBase.paintEvent`,

:meth:`.FigureCanvasQTAggBase.blit`, and

:meth:`.FigureCanvasQTAggBase.print_figure` methods have moved to

:meth:`.FigureCanvasQTAgg.paintEvent`, :meth:`.FigureCanvasQTAgg.blit`, and

:meth:`.FigureCanvasQTAgg.print_figure`. The first two methods assume that

the instance is also a :class:`QWidget` so to use

:class:`FigureCanvasQTAggBase` it was required to multiple inherit

from a :class:`QWidget` sub-class.

Having moved all of its methods either up or down the class hierarchy

:class:`FigureCanvasQTAggBase` has been deprecated. To do this with

out warning and to preserve as much API as possible,

:class:`.backend_qt5.FigureCanvasQTAggBase` now inherits from

:class:`.backend_qt5.FigureCanvasQTAgg`.

The MRO for :class:`FigureCanvasQTAgg` and

:class:`FigureCanvasQTAggBase` used to be ::

and ::

respectively. They are now ::

and ::

Removed attributes

The unused `FONT_SCALE` and `fontd` attributes of the `RendererSVG` class have

been removed.

API changes for ``constrained_layout``

The new constrained_layout functionality has some minor (largely backwards-

compatible) API changes. See

:ref:`sphx_glr_tutorials_intermediate_constrainedlayout_guide.py` for

more details on this functionality.

This requires a new dependency on kiwisolver_.

_https://github.com/nucleic/kiwi

kwarg ``fig`` deprectated in `.GridSpec.get_subplot_params`

Use ``figure`` instead of ``fig``, which is now deprecated.

`Axes.imshow` clips RGB values to the valid range

When `Axes.imshow` is passed an RGB or RGBA value with out-of-range

values, it now logs a warning and clips them to the valid range.

The old behaviour, wrapping back in to the range, often hid outliers

and made interpreting RGB images unreliable.

Deprecation of qt binding rcparams

The :rc:`backend.qt4` and :rc:`backend.qt5` rcParams were deprecated

in version 2.2. In order to force the use of a specific Qt binding,

either import that binding first, or set the ``QT_API`` environment

variable.

GTKAgg and GTKCairo backends deprecated

The GTKAgg and GTKCairo backends have been deprecated. These obsolete backends

allow figures to be rendered via the GTK+ 2 toolkit. They are untested, known

to be broken, will not work with Python 3, and their use has been discouraged

for some time. Instead, use the `GTK3Agg` and `GTK3Cairo` backends for

rendering to GTK+ 3 windows.