.. _whats=new:

write a new subclass of `-.scale.ScaleBase`. This can be accessed by

``ax.set_yscale('function', functions=(forward, inverse))``, where

``forward`` and ``inverse`` are callables that return the scale transform and

its inverse. See the last example in :doc:`/gallery/scales/scales`.

A new method for creating legends for scatter plots has been introduced.

Previously, in order to obtain a legend for a :meth:`-.axes.Axes.scatter`

plot, one could either plot several scatters, each with an individual label,

or create proxy artists to show in the legend manually.

Now, :class:`-.collections.PathCollection` provides a method

:meth:`-.collections.PathCollection.legend_elements` to obtain the handles and labels

for a scatter plot in an automated way. This makes creating a legend for a

scatter plot as easy as::

An example can be found in

:ref:`automatedlegendcreation`.

Add ``inaxes`` method to `FigureCanvas`

The `FigureCanvas` class has now an ``inaxes`` method to check whether a point is in an axes

and returns the topmost axes, else None.

`ArtistInspector.get_aliases` previously returned the set of aliases as

This value is also stored in `ArtistInspector.aliasd`, which has likewise

`ConnectionPatch` accepts arbitrary transforms

Lines created with the 3d projection in mplot3d can now access the data using

``mplot3d.art3d.Line3D.get_data_3d()`` which returns a tuple of array_likes containing

the (x, y, z) data. The equivalent ``mplot3d.art3d.Line3D.set_data_3d(x, y, z)``

can be used to modify the data of an existing Line3D.

The :meth:`-mpl_toolkits.mplot3d.Axes3D.voxels` method now takes a ``shade``

parameter that defaults to ``True``. This shades faces based on their

orientation, behaving just like the matching parameters to

:meth:`-mpl_toolkits.mplot3d.Axes3D.bar3d`.

The plot below shows how this affects the output.

Added `Axis.get_inverted` and `Axis.set_inverted`

The `Axis.get_inverted` and `Axis.set_inverted` methods query and set whether

They perform tasks similar to `Axes.xaxis_inverted`, `Axes.yaxis_inverted`,

`Axes.invert_xaxis`, and `Axes.invert_yaxis`, with the specific difference that

`.set_inverted` makes it easier to set the invertedness of an axis regardless

of whether it had previously been inverted before.

`EngFormatter` now accepts `usetex`, `useMathText` as keyword only arguments

A public API has been added to `EngFormatter` to control how the numbers in the

ticklabels will be rendered. By default, ``useMathText`` evaluates to

``rcParams['axes.formatter.use_mathtext']`` and ``usetex`` evaluates to

``rcParams['text.usetex']``.

If either is ``True`` then the numbers will be encapsulated by ``$`` signs.

When using ``TeX`` this implies that the numbers will be shown in TeX's math

font. When using mathtext, the ``$`` signs around numbers will ensure unicode

rendering (as implied by mathtext). This will make sure that the minus signs

in the ticks are rendered as the unicode=minus (U+2212) when using mathtext

(without relying on the ``fix_minus`` method).

Figure managers now support a ``button_press`` event for mouse buttons, similar

to the ``key_press`` events. This allows binding actions to mouse buttons (see

`.MouseButton`) The first application of this mechanism is support of forward/backward mouse

buttons in figures created with the Qt5 backend.

*progress_callback* argument to ani.save()

The method .FuncAnimation.save() gained an optional *progress_callback* argument to notify the saving progress.

Add ``cache_frame_data`` keyword-only argument into ``matplotlib.animation.FuncAnimation``

| ``matplotlib.animation.FuncAnimation`` has been caching frame data by default; however, this caching is not ideal in certain cases e.g. When ``FuncAnimation`` needs to be only drawn(not saved) interactively and memory required by frame data is quite large. By adding ``cache_frame_data`` keyword-only argument, users can now disable this caching; thereby, this new argument provides a fix for issue #8528.

We acknowledge that most people want to watch a gif more than once. Saving an animation as a gif with PillowWriter now produces an endless looping gif.

Adjusted ``matplotlib.widgets.Slider`` to have vertical orientation

The :class:`matplotlib.widgets.Slider` widget now takes an optional argument

``orientation`` which indicates the direction (``'horizontal'`` or

``'vertical'``) that the slider should take.

Previously, the rc file keys ``pgf.preamble`` and ``text.latex.preamble`` were parsed using commmas as separators. This would break valid LaTeX code, such as::

\usepackage[protrusion=true, expansion=false]{microtype}

The parsing has been modified to pass the complete line to the LaTeX system,

keeping all commas. Passing a list of strings from within a Python script still works as it used to.

Added support for MacOSX backend for PyPy

Fixed issue with MacOSX backend for PyPy and also for non-framework Python

installations.

`matplotlib.set_loglevel`/`.pyplot.set_loglevel` can be called to display more

(or less) detailed logging output.