1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
|
API Changes in 2.2.0
====================
New dependency
--------------
`kiwisolver <https://github.com/nucleic/kiwi>`__ is now a required
dependency to support the new constrained_layout, see
:ref:`constrainedlayout_guide` for
more details.
Deprecations
------------
Classes, functions, and methods
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The unused and untested ``Artist.onRemove`` and ``Artist.hitlist`` methods have
been deprecated.
The now unused ``mlab.less_simple_linear_interpolation`` function is
deprecated.
The unused ``ContourLabeler.get_real_label_width`` method is deprecated.
The unused ``FigureManagerBase.show_popup`` method is deprecated. This
introduced in e945059b327d42a99938b939a1be867fa023e7ba in 2005 but never built
out into any of the backends.
``backend_tkagg.AxisMenu`` is deprecated, as it has become unused since the
removal of "classic" toolbars.
Changed function signatures
~~~~~~~~~~~~~~~~~~~~~~~~~~~
kwarg ``fig`` to `.GridSpec.get_subplot_params` is
deprecated, use ``figure`` instead.
Using `.pyplot.axes` with an `~matplotlib.axes.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)``.
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``.
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.
rcparams
~~~~~~~~
The ``backend.qt4`` and ``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.
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.
Deprecated ``Axis.unit_data``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use ``Axis.units`` (which has long existed) instead.
Removals
--------
Function Signatures
~~~~~~~~~~~~~~~~~~~
Contouring no longer supports ``legacy`` corner masking. The
deprecated ``ContourSet.vmin`` and ``ContourSet.vmax`` properties have
been removed.
Passing ``None`` instead of ``"none"`` as format to `~.Axes.errorbar` is no
longer supported.
The ``bgcolor`` keyword argument to ``Axes`` has been removed.
Modules, methods, and functions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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.
``mencoder`` can no longer be used to encode animations.
The unused ``FONT_SCALE`` and ``fontd`` attributes of the `.RendererSVG`
class have been removed.
colormaps
~~~~~~~~~
The ``spectral`` colormap has been removed. The ``Vega*`` colormaps, which
were aliases for the ``tab*`` colormaps, have been removed.
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``).
Only accept string-like for Categorical input
---------------------------------------------
Do not accept mixed string / float / int input, only
strings are valid categoricals.
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`.
``Axes3D.get_xlim``, ``get_ylim`` and ``get_zlim`` now return a tuple
---------------------------------------------------------------------
They previously returned an array. Returning a tuple is consistent with the
behavior for 2D axes.
Exception type changes
----------------------
If `.MovieWriterRegistry` can't find the requested `.MovieWriter`, a
more helpful `RuntimeError` message is now raised instead of the
previously raised `KeyError`.
``matplotlib.tight_layout.auto_adjust_subplotpars`` now raises `ValueError`
instead of `RuntimeError` when sizes of input lists don't match
`.Figure.set_figwidth` and `.Figure.set_figheight` default *forward* to True
----------------------------------------------------------------------------
`matplotlib.figure.Figure.set_figwidth` and
`matplotlib.figure.Figure.set_figheight` had the keyword argument
``forward=False`` by default, but `.figure.Figure.set_size_inches` now defaults
to ``forward=True``. This makes these functions consistent.
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.
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.
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 ``backend_qt5agg.FigureCanvasQTAggBase`` has been
moved to ``backend_qt5.FigureCanvasQT`` so it can be shared with the
cairo implementation. The ``FigureCanvasQTAggBase.paintEvent``,
``FigureCanvasQTAggBase.blit``, and ``FigureCanvasQTAggBase.print_figure``
methods have moved to ``FigureCanvasQTAgg.paintEvent``,
``FigureCanvasQTAgg.blit``, and ``FigureCanvasQTAgg.print_figure``.
The first two methods assume that the instance is also a ``QWidget`` so to use
``FigureCanvasQTAggBase`` it was required to multiple inherit from a
``QWidget`` sub-class.
Having moved all of its methods either up or down the class hierarchy
``FigureCanvasQTAggBase`` has been deprecated. To do this without warning and
to preserve as much API as possible, ``.backend_qt5agg.FigureCanvasQTAggBase``
now inherits from ``backend_qt5.FigureCanvasQTAgg``.
The MRO for ``FigureCanvasQTAgg`` and ``FigureCanvasQTAggBase`` used to
be ::
[matplotlib.backends.backend_qt5agg.FigureCanvasQTAgg,
matplotlib.backends.backend_qt5agg.FigureCanvasQTAggBase,
matplotlib.backends.backend_agg.FigureCanvasAgg,
matplotlib.backends.backend_qt5.FigureCanvasQT,
PyQt5.QtWidgets.QWidget,
PyQt5.QtCore.QObject,
sip.wrapper,
PyQt5.QtGui.QPaintDevice,
sip.simplewrapper,
matplotlib.backend_bases.FigureCanvasBase,
object]
and ::
[matplotlib.backends.backend_qt5agg.FigureCanvasQTAggBase,
matplotlib.backends.backend_agg.FigureCanvasAgg,
matplotlib.backend_bases.FigureCanvasBase,
object]
respectively. They are now ::
[matplotlib.backends.backend_qt5agg.FigureCanvasQTAgg,
matplotlib.backends.backend_agg.FigureCanvasAgg,
matplotlib.backends.backend_qt5.FigureCanvasQT,
PyQt5.QtWidgets.QWidget,
PyQt5.QtCore.QObject,
sip.wrapper,
PyQt5.QtGui.QPaintDevice,
sip.simplewrapper,
matplotlib.backend_bases.FigureCanvasBase,
object]
and ::
[matplotlib.backends.backend_qt5agg.FigureCanvasQTAggBase,
matplotlib.backends.backend_qt5agg.FigureCanvasQTAgg,
matplotlib.backends.backend_agg.FigureCanvasAgg,
matplotlib.backends.backend_qt5.FigureCanvasQT,
PyQt5.QtWidgets.QWidget,
PyQt5.QtCore.QObject,
sip.wrapper,
PyQt5.QtGui.QPaintDevice,
sip.simplewrapper,
matplotlib.backend_bases.FigureCanvasBase,
object]
`.axes.Axes.imshow` clips RGB values to the valid range
-------------------------------------------------------
When `.axes.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.
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.
|
